one.edee.babylon.sheets.gsheets

Class LightGSheetService

java.lang.Object

one.edee.babylon.sheets.gsheets.LightGSheetService

public class LightGSheetService
extends Object

Implements business logic by calling Google Sheets API client library in a way that optimizes number of HTTP requests sent. Does not attempt to build a general abstraction over the client library.

Constructor Summary

Constructors

Constructor and Description
LightGSheetService(GSheetApiRequestFactory gSheetApiRequestFactory, GSheetsClient gsClient)

Method Summary

Modifier and Type	Method and Description
void	deleteSheets(String spreadsheetId, Collection<Integer> sheetIds)
List<com.google.api.services.sheets.v4.model.Sheet>	listSheetsEagerly(String spreadsheetId) Lists all sheets of a spreadsheet also fetching their cell data.
List<com.google.api.services.sheets.v4.model.Sheet>	listSheetsLazily(String spreadsheetId) Lists all sheets of a spreadsheet without loading their cell data.
com.google.api.services.sheets.v4.model.Sheet	loadSheet(String spreadsheetId, String sheetTitle) Loads sheet from given spreadsheet, if exists.
void	updateSheetStyle(String spreadsheetId, Integer sheetId, List<String> lockedCellEditors, List<String> translatedAutomatically, List<String> translatedHistorically) Updates the style and configuration of a specified sheet in a Google Spreadsheet.
void	uploadDataToGoogleSheet(String spreadsheetId, String sheetTitle, List<List<String>> sheetRows) Stores data in a new sheet in given spreadsheet.
void	uploadDataToGoogleSheet(String spreadsheetId, String sheetTitle, List<List<String>> sheetRows, int rowsToFreeze, int colsToFreeze) Stores data in a new sheet in given spreadsheet.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LightGSheetService

public LightGSheetService(GSheetApiRequestFactory gSheetApiRequestFactory,
                          GSheetsClient gsClient)

Method Detail

listSheetsLazily

public List<com.google.api.services.sheets.v4.model.Sheet> listSheetsLazily(String spreadsheetId)
                                                                     throws GeneralSecurityException,
                                                                            IOException

Lists all sheets of a spreadsheet without loading their cell data.

Parameters:

spreadsheetId - id of spreadsheet

Returns:

all sheets of spreadsheet spreadSheetId

Throws:

GeneralSecurityException

IOException

listSheetsEagerly

public List<com.google.api.services.sheets.v4.model.Sheet> listSheetsEagerly(String spreadsheetId)
                                                                      throws GeneralSecurityException,
                                                                             IOException

Lists all sheets of a spreadsheet also fetching their cell data.

Parameters:

spreadsheetId - id of spreadsheet

Returns:

all sheets of spreadsheet spreadSheetId

Throws:

GeneralSecurityException

IOException

loadSheet

public com.google.api.services.sheets.v4.model.Sheet loadSheet(String spreadsheetId,
                                                               String sheetTitle)
                                                        throws GeneralSecurityException,
                                                               IOException

Loads sheet from given spreadsheet, if exists.

Parameters:

spreadsheetId - id of spreadsheet to find in

sheetTitle - title of sheet to find

Returns:

sheet sheetTitle from spreadsheet , or null if not found

Throws:

GeneralSecurityException

IOException

uploadDataToGoogleSheet

public void uploadDataToGoogleSheet(String spreadsheetId,
                                    String sheetTitle,
                                    List<List<String>> sheetRows)
                             throws GeneralSecurityException,
                                    IOException

Stores data in a new sheet in given spreadsheet.

Parameters:

spreadsheetId - id of spreadsheet to create sheet in

sheetTitle - name of the new sheet

sheetRows - sheet data to store

Throws:

GeneralSecurityException

IOException

uploadDataToGoogleSheet

public void uploadDataToGoogleSheet(String spreadsheetId,
                                    String sheetTitle,
                                    List<List<String>> sheetRows,
                                    int rowsToFreeze,
                                    int colsToFreeze)
                             throws GeneralSecurityException,
                                    IOException

Stores data in a new sheet in given spreadsheet.

Parameters:

spreadsheetId - id of spreadsheet to create sheet in

sheetTitle - name of the new sheet

sheetRows - sheet data to store

rowsToFreeze - number of rows to freeze

colsToFreeze - number of cols to freeze

Throws:

GeneralSecurityException

IOException

updateSheetStyle

public void updateSheetStyle(String spreadsheetId,
                             Integer sheetId,
                             List<String> lockedCellEditors,
                             List<String> translatedAutomatically,
                             List<String> translatedHistorically)
                      throws GeneralSecurityException,
                             IOException

Updates the style and configuration of a specified sheet in a Google Spreadsheet. This includes wrapping text in all cells, resizing columns, protecting cells, hiding specific columns, and applying color changes to specified cells.

Parameters:

spreadsheetId - the ID of the Google Spreadsheet

sheetId - the ID of the sheet within the spreadsheet to update

lockedCellEditors - a list of email addresses permitted to edit protected cells in the first two columns

translatedAutomatically - a list of cell identifiers (formatted as "row_column") to apply a specific background color, indicating automatic translation

translatedHistorically - a list of cell identifiers (formatted as "row_column") to apply a different background color, indicating manual translation from historical data

Throws:

GeneralSecurityException - if there is an authentication or API access issue

IOException - if an issue occurs during communication with the Google Sheets API

deleteSheets

public void deleteSheets(String spreadsheetId,
                         Collection<Integer> sheetIds)
                  throws GeneralSecurityException,
                         IOException

Throws:

GeneralSecurityException

IOException