com.google.gdata.client.spreadsheet

Class FeedURLFactory

java.lang.Object

com.google.gdata.client.spreadsheet.FeedURLFactory

public class FeedURLFactory
extends Object

Provides feed URLs that can be used with a Spreadsheets server.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_SPREADSHEETS_URL URL of the server to connect to by default.

Constructor Summary

Constructors

Constructor and Description
FeedURLFactory(String url) Creates an URL factory targeted to a server.

Method Summary

Methods

Modifier and Type	Method and Description
URL	getBaseUrl() Returns the URL used as a base for the generated URLs.
URL	getCellFeedUrl(String spreadsheetKey, String worksheetId, String visibility, String projection) Creates a URL you can use to get a CellFeed, which treats the spreadsheet like spatially oriented cells.
static FeedURLFactory	getDefault() Gets the default instance of this factory, targeted to "https://spreadsheets.google.com".
URL	getListFeedUrl(String spreadsheetKey, String worksheetId, String visibility, String projection) Creates a URL you can use to get a ListFeed, which treats the spreadsheet as a list of rows.
URL	getRecordFeedUrl(String spreadsheetKey, String tableId) Creates a url that you can use to get a feed of records from a table.
static String	getSpreadsheetKeyFromUrl(String url) Turns a Google Spreadsheets URL directly into the spreadsheet key.
URL	getSpreadsheetsFeedUrl() Gets a URL you can use to get a SpreadsheetFeed of all your spreadsheets.
URL	getTableFeedUrl(String spreadsheetKey) Creates a url that you can use to get a Table Feed of all the tables within a spreadsheet.
URL	getWorksheetFeedUrl(String spreadsheetKey, String visibility, String projection) Creates a URL you can use to get a WorksheetFeed of all the worksheets within a spreadsheet.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SPREADSHEETS_URL

public static final String DEFAULT_SPREADSHEETS_URL

URL of the server to connect to by default. Currently "https://spreadsheets.google.com".

See Also:

Constant Field Values

Constructor Detail

FeedURLFactory

public FeedURLFactory(String url)
               throws MalformedURLException

Creates an URL factory targeted to a server. As long as you don't need to connect to a nonstandard URL, different from "https://spreadsheets.google.com", you should consider calling getDefault() instead.

Parameters:

url - an URL used as a base for the generated URLs

Throws:

MalformedURLException

Method Detail

getDefault

public static FeedURLFactory getDefault()

Gets the default instance of this factory, targeted to "https://spreadsheets.google.com".

Returns:

the default FeedURLFactory

getBaseUrl

public URL getBaseUrl()

Returns the URL used as a base for the generated URLs.

getSpreadsheetsFeedUrl

public URL getSpreadsheetsFeedUrl()

Gets a URL you can use to get a SpreadsheetFeed of all your spreadsheets.

getWorksheetFeedUrl

public URL getWorksheetFeedUrl(String spreadsheetKey,
                      String visibility,
                      String projection)
                        throws MalformedURLException

Creates a URL you can use to get a WorksheetFeed of all the worksheets within a spreadsheet. This requires the spreadsheet key, which can be obtained from the URL of the AJAX page through getSpreadsheetKeyFromUrl(String), or via using the My Spreadsheets feed.

Parameters:

spreadsheetKey - a spreadsheet key, like o1123123.12312312

Throws:

MalformedURLException

getTableFeedUrl

public URL getTableFeedUrl(String spreadsheetKey)
                    throws MalformedURLException

Creates a url that you can use to get a Table Feed of all the tables within a spreadsheet.

Parameters:

spreadsheetKey - key of the workbook to get the table feed from.

Throws:

MalformedURLException

getRecordFeedUrl

public URL getRecordFeedUrl(String spreadsheetKey,
                   String tableId)
                     throws MalformedURLException

Creates a url that you can use to get a feed of records from a table.

Parameters:

spreadsheetKey - key of the workbook to get the table feed from.

tableId - id of the table to get a record feed from.

Throws:

MalformedURLException

getListFeedUrl

public URL getListFeedUrl(String spreadsheetKey,
                 String worksheetId,
                 String visibility,
                 String projection)
                   throws MalformedURLException

Creates a URL you can use to get a ListFeed, which treats the spreadsheet as a list of rows. Like getWorksheetFeedUrl(String, String, String), this requires the spreadsheet key. This also requires the worksheet identifier. See the documentation on how worksheets can be identified.

Parameters:

spreadsheetKey - a spreadsheet key, like 01123123.12312312

worksheetId - a worksheet identifier or a 1-based positional indicator

Throws:

MalformedURLException

getCellFeedUrl

public URL getCellFeedUrl(String spreadsheetKey,
                 String worksheetId,
                 String visibility,
                 String projection)
                   throws MalformedURLException

Creates a URL you can use to get a CellFeed, which treats the spreadsheet like spatially oriented cells. Like getWorksheetFeedUrl(String, String, String), this requires the spreadsheet key. This also requires the worksheet identifier. See the documentation on how worksheets can be identified.

Parameters:

spreadsheetKey - a spreadsheet key, like 01123123.12312312

worksheetId - a worksheet identifier or a 1-based positional indicator

Throws:

MalformedURLException

getSpreadsheetKeyFromUrl

public static String getSpreadsheetKeyFromUrl(String url)
                                       throws IllegalArgumentException

Turns a Google Spreadsheets URL directly into the spreadsheet key.

Parameters:

url - a URL like http://abcd.spreadsheets.google.com/ccc?id=o1231.1231.1231.1231; if just the ID is specified, this will also work

Returns:

the spreadsheet key (o1231.1231)

Throws:

IllegalArgumentException - if the URL is not formatted correctly