|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.google.gdata.client.Service
public class Service
The Service class represents a client connection to a GData service. It encapsulates all protocol-level interactions with the GData server and acts as a helper class for higher level entities (feeds, entries, etc) that invoke operations on the server and process their results.
This class provides the base level common functionality required to access any GData service. It is also designed to act as a base class that can be customized for specific types of GData services. Examples of supported customizations include:
ExtensionProfile
associated with the service to allow Atom/RSS
extension elements to be automatically converted to/from the Feed
/
Entry
object model.
Nested Class Summary | |
---|---|
static interface |
Service.GDataRequest
The GDataRequest interface represents a streaming connection to a GData service that can be used either to send request data to the service using an OutputStream (or XmlWriter for XML content) or to receive response data from the service as an InputStream (or ParseSource for XML data). |
static interface |
Service.GDataRequestFactory
The GDataRequestFactory interface defines a basic factory interface for constructing a new GDataRequest interface. |
static class |
Service.Versions
The Versions class defines Version constants representing the set
of active versions of the GData core protocol and common data model
classes. |
Field Summary | |
---|---|
protected int |
connectTimeout
Client-configured connection timeout value. |
protected ExtensionProfile |
extProfile
|
protected Service.GDataRequestFactory |
requestFactory
The GDataRequestFactory associated with this service. |
Constructor Summary | |
---|---|
Service()
Constructs a new Service instance that is configured to accept arbitrary extension data within feed or entry elements. |
Method Summary | ||
---|---|---|
|
batch(java.net.URL feedUrl,
F inputFeed)
Executes several operations (insert, update or delete) on the entries that are part of the input Feed . |
|
protected void |
closeSource(ParseSource source)
Closes streams and readers associated with a parse source. |
|
Service.GDataRequest |
createBatchRequest(java.net.URL feedUrl)
Creates a new GDataRequest that can be used to execute several insert/update/delete operations in one request by writing a feed into the request stream to read a feed containing the result of the batch operations from the response stream. |
|
Service.GDataRequest |
createDeleteRequest(java.net.URL entryUrl)
Creates a new GDataRequest that can be used to delete an Atom entry. |
|
Service.GDataRequest |
createEntryRequest(java.net.URL entryUrl)
Returns a GDataRequest instance that can be used to access an entry's contents as a stream, given the URL of the entry. |
|
Service.GDataRequest |
createFeedRequest(Query query)
Executes a GData query request against the target service and returns the resulting feed results via an input stream. |
|
Service.GDataRequest |
createFeedRequest(java.net.URL feedUrl)
Executes a GData feed request against the target service and returns the resulting feed results via an input stream. |
|
Service.GDataRequest |
createInsertRequest(java.net.URL feedUrl)
Creates a new GDataRequest that can be used to insert a new entry into a feed using the request stream and to read the resulting entry content from the response stream. |
|
protected Service.GDataRequest |
createRequest(Query query,
ContentType inputType)
Creates a new GDataRequest for querying the service. |
|
Service.GDataRequest |
createRequest(Service.GDataRequest.RequestType type,
java.net.URL requestUrl,
ContentType inputType)
Creates a new GDataRequest for use by the service. |
|
Service.GDataRequest |
createUpdateRequest(java.net.URL entryUrl)
Creates a new GDataRequest that can be used to update an existing Atom entry. |
|
void |
delete(java.net.URI resourceUri)
Deletes an existing entry (and associated media content, if any) using the specified edit URI. |
|
void |
delete(java.net.URI resourceUri,
java.lang.String etag)
Deletes an existing entry (and associated media content, if any) using the specified edit URI. |
|
void |
delete(java.net.URL resourceUrl)
Deletes an existing entry (and associated media content, if any) using the specified edit URL. |
|
void |
delete(java.net.URL resourceUrl,
java.lang.String etag)
Deletes an existing entry (and associated media content, if any) using the specified edit URL. |
|
protected void |
endVersionScope()
|
|
ContentType |
getContentType()
Returns the default ContentType for data associated with this GData service. |
|
|
getEntry(java.net.URL entryUrl,
java.lang.Class<E> entryClass)
Returns an Atom entry instance, given the URL of the entry. |
|
|
getEntry(java.net.URL entryUrl,
java.lang.Class<E> entryClass,
DateTime ifModifiedSince)
Returns an Atom entry instance, given the URL of the entry and an if-modified-since date. |
|
|
getEntry(java.net.URL entryUrl,
java.lang.Class<E> entryClass,
java.lang.String etag)
Returns an Atom entry instance given the URL of the entry, if its current entity tag is different than the provided value. |
|
ExtensionProfile |
getExtensionProfile()
Returns the ExtensionProfile that defines any expected extensions
to the base RSS/Atom content model. |
|
|
getFeed(Query query,
java.lang.Class<F> feedClass)
Returns the Feed associated with a particular query. |
|
|
getFeed(Query query,
java.lang.Class<F> feedClass,
DateTime ifModifiedSince)
Returns the Feed associated with a particular query, if it's been modified since the specified date. |
|
|
getFeed(Query query,
java.lang.Class<F> feedClass,
java.lang.String etag)
Returns the Feed associated with a particular query, if if the entity tag associated with it has changed. |
|
|
getFeed(java.net.URL feedUrl,
java.lang.Class<F> feedClass)
Returns the Feed associated with a particular feed URL. |
|
|
getFeed(java.net.URL feedUrl,
java.lang.Class<F> feedClass,
DateTime ifModifiedSince)
Returns the Feed associated with a particular feed URL, if it's been modified since the specified date. |
|
|
getFeed(java.net.URL feedUrl,
java.lang.Class<F> feedClass,
java.lang.String etag)
Returns the Feed associated with a particular feed URL if the entity tag associated with it has changed. |
|
Version |
getProtocolVersion()
Returns the service protocol version that will be used for requests generated by this service. |
|
Service.GDataRequestFactory |
getRequestFactory()
Returns the GDataRequestFactory currently associated with the service. |
|
java.lang.String |
getServiceVersion()
Returns information about the service version. |
|
java.io.InputStream |
getStreamFromLink(Link link)
|
|
static Version |
getVersion()
Returns the current Version of the GData core protocol. |
|
protected static Version |
initServiceVersion(java.lang.Class<? extends Service> serviceClass,
Version defaultVersion)
Initializes the version information for a specific service type. |
|
|
insert(java.net.URL feedUrl,
E entry)
Inserts a new Entry into a feed associated
with the target service. |
|
|
introspect(java.net.URL feedUrl,
java.lang.Class<S> serviceClass)
Returns the Atom introspection Service Document associated with a particular feed URL. |
|
protected
|
parseEntry(java.lang.Class<E> entryClass,
ParseSource entrySource)
Parse an entry of the specified class from a parse source. |
|
|
query(Query query,
java.lang.Class<F> feedClass)
Executes a GData query against the target service and returns the Feed containing entries that match the query result. |
|
|
query(Query query,
java.lang.Class<F> feedClass,
DateTime ifModifiedSince)
Executes a GData query against the target service and returns the Feed containing entries that match the query result, if it's been
modified since the specified date. |
|
|
query(Query query,
java.lang.Class<F> feedClass,
java.lang.String etag)
Executes a GData query against the target service and returns the Feed containing entries that match the query result if the etag
for the target feed does not match the provided value. |
|
void |
setAcceptLanguage(java.lang.String acceptedLanguages)
Defines the languages accepted by the application. |
|
void |
setConnectTimeout(int timeout)
Sets the default wait timeout (in milliseconds) for a connection to the remote GData service. |
|
void |
setContentType(ContentType contentType)
Sets the default ContentType for writing data to the GData service. |
|
void |
setExtensionProfile(ExtensionProfile v)
Sets the ExtensionProfile that defines any expected extensions to
the base RSS/Atom content model. |
|
void |
setProtocolVersion(Version v)
Sets the service protocol version that will be used for requests associated with this service. |
|
void |
setReadTimeout(int timeout)
Sets the default wait timeout (in milliseconds) for a response from the remote GData service. |
|
void |
setRequestFactory(Service.GDataRequestFactory requestFactory)
Sets the GDataRequestFactory currently associated with the service. |
|
void |
setTimeouts(Service.GDataRequest request)
Sets timeout value for GDataRequest. |
|
protected void |
startVersionScope()
|
|
|
update(java.net.URL entryUrl,
E entry)
Updates an existing Entry by writing it to
the specified entry edit URL. |
|
|
update(java.net.URL entryUrl,
E entry,
java.lang.String etag)
Updates an existing Entry by writing it to
the specified entry edit URL. |
|
void |
useSsl()
Sets the HttpGDataRequest.Factory associate with the service to use secure connections. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected ExtensionProfile extProfile
protected Service.GDataRequestFactory requestFactory
protected int connectTimeout
Constructor Detail |
---|
public Service()
Method Detail |
---|
protected static Version initServiceVersion(java.lang.Class<? extends Service> serviceClass, Version defaultVersion)
Service
will generally call this method from within their static
initializers to bind version information for the associated service.
serviceClass
- the service type being initialized.defaultVersion
- the service version expected by this client library.public static Version getVersion()
Version
of the GData core protocol.
public Version getProtocolVersion()
public void setProtocolVersion(Version v)
v
- new service protocol version.protected void startVersionScope()
protected void endVersionScope()
public java.lang.String getServiceVersion()
public ExtensionProfile getExtensionProfile()
ExtensionProfile
that defines any expected extensions
to the base RSS/Atom content model.
public void setExtensionProfile(ExtensionProfile v)
ExtensionProfile
that defines any expected extensions to
the base RSS/Atom content model.
public Service.GDataRequestFactory getRequestFactory()
public void setRequestFactory(Service.GDataRequestFactory requestFactory)
public void useSsl()
public void setAcceptLanguage(java.lang.String acceptedLanguages)
*
to accept all languages, the exception
in the exception NotAcceptableException
.
The service will choose the best available language on this list. Check the
attribute xml:lang
on the relevant tags, such as atom:content,
atom:title and atom:category.
acceptedLanguages
- list of accepted languages, as defined
in section 14.4 of RFC 2616public Service.GDataRequest createRequest(Service.GDataRequest.RequestType type, java.net.URL requestUrl, ContentType inputType) throws java.io.IOException, ServiceException
createRequest(Query, ContentType)
instead.
java.io.IOException
ServiceException
protected Service.GDataRequest createRequest(Query query, ContentType inputType) throws java.io.IOException, ServiceException
java.io.IOException
ServiceException
public void setTimeouts(Service.GDataRequest request)
public ContentType getContentType()
public void setContentType(ContentType contentType)
public void setConnectTimeout(int timeout)
timeout
- the read timeout. A value of zero indicates an infinite
timeout.
java.lang.IllegalArgumentException
- if the timeout value is negative.URLConnection.setConnectTimeout(int)
public void setReadTimeout(int timeout)
timeout
- the read timeout. A value of zero indicates an infinite
timeout.
java.lang.IllegalArgumentException
- if the timeout value is negative.URLConnection.setReadTimeout(int)
protected <E extends BaseEntry<?>> E parseEntry(java.lang.Class<E> entryClass, ParseSource entrySource) throws java.io.IOException, ServiceException
java.io.IOException
ServiceException
public <S extends ServiceDocument> S introspect(java.net.URL feedUrl, java.lang.Class<S> serviceClass) throws java.io.IOException, ServiceException
feedUrl
- the URL associated with a feed. This URL can not include any
query parameters.serviceClass
- the class used to represent a service document.
java.io.IOException
- error sending request or reading the feed.
ParseException
- error parsing the returned
service data.
ResourceNotFoundException
- invalid feed URL.
ServiceException
- system error retrieving service document.public <F extends BaseFeed<?,?>> F getFeed(java.net.URL feedUrl, java.lang.Class<F> feedClass, DateTime ifModifiedSince) throws java.io.IOException, ServiceException
feedUrl
- the URL associated with a feed. This URL can include GData
query parameters.feedClass
- the class used to represent a service Feed.ifModifiedSince
- used to set a precondition date that indicates the
feed should be returned only if it has been modified after the
specified date. A value of null
indicates no precondition.
java.io.IOException
- error sending request or reading the feed.
NotModifiedException
- if the feed resource has
not been modified since the specified precondition date.
ParseException
- error parsing the returned
feed data.
ResourceNotFoundException
- invalid feed URL.
ServiceException
- system error retrieving feed.public <F extends BaseFeed<?,?>> F getFeed(java.net.URL feedUrl, java.lang.Class<F> feedClass, java.lang.String etag) throws java.io.IOException, ServiceException
feedUrl
- the URL associated with a feed. This URL can include GData
query parameters.feedClass
- the class used to represent a service Feed.etag
- used to provide an entity tag that indicates the feed should be
returned only if the entity tag of the current representation is
different from the provided value. A value of null
indicates
unconditional return.
java.io.IOException
- error sending request or reading the feed.
NotModifiedException
- if the feed resource entity tag matches the
provided value.
ParseException
- error parsing the returned
feed data.
ResourceNotFoundException
- invalid feed URL.
ServiceException
- system error retrieving feed.public <F extends BaseFeed<?,?>> F getFeed(java.net.URL feedUrl, java.lang.Class<F> feedClass) throws java.io.IOException, ServiceException
feedUrl
- the URL associated with a feed. This URL can include GData
query parameters.feedClass
- the class used to represent a service Feed.
java.io.IOException
- error sending request or reading the feed.
ParseException
- error parsing the returned
feed data.
ResourceNotFoundException
- invalid feed URL.
ServiceException
- system error retrieving feed.public <F extends BaseFeed<?,?>> F getFeed(Query query, java.lang.Class<F> feedClass) throws java.io.IOException, ServiceException
query
- feed query.feedClass
- the class used to represent a service Feed.
java.io.IOException
- error sending request or reading the feed.
ParseException
- error parsing the returned feed data.
ResourceNotFoundException
- invalid feed URL.
ServiceException
- system error retrieving feed.public <F extends BaseFeed<?,?>> F getFeed(Query query, java.lang.Class<F> feedClass, DateTime ifModifiedSince) throws java.io.IOException, ServiceException
query
- feed query.feedClass
- the class used to represent a service Feed.ifModifiedSince
- used to set a precondition date that indicates the
feed should be returned only if it has been modified after the
specified date. A value of null
indicates no precondition.
java.io.IOException
- error sending request or reading the feed.
ServiceException
- system error retrieving feed.public <F extends BaseFeed<?,?>> F getFeed(Query query, java.lang.Class<F> feedClass, java.lang.String etag) throws java.io.IOException, ServiceException
query
- feed query.feedClass
- the class used to represent a service Feed.etag
- used to provide an entity tag that indicates the feed should be
returned only if the entity tag of the current representation is
different from the provided value. A value of null
indicates
unconditional return.
java.io.IOException
- error sending request or reading the feed.
NotModifiedException
- if the feed resource entity tag matches the
provided value.
ParseException
- error parsing the returned feed data.
ResourceNotFoundException
- invalid feed URL.
ServiceException
- system error retrieving feed.public Service.GDataRequest createFeedRequest(java.net.URL feedUrl) throws java.io.IOException, ServiceException
feedUrl
- URL that defines target feed.
java.io.IOException
- error communicating with the GData service.
ServiceException
- creation of query feed request failed.Query.getUrl()
public Service.GDataRequest createFeedRequest(Query query) throws java.io.IOException, ServiceException
query
- feed query.
java.io.IOException
- error communicating with the GData service.
ServiceException
- creation of query feed request failed.Query.getUrl()
public <E extends BaseEntry<?>> E getEntry(java.net.URL entryUrl, java.lang.Class<E> entryClass) throws java.io.IOException, ServiceException
entryUrl
- resource URL for the entry.entryClass
- class used to represent service entries.
java.io.IOException
- error communicating with the GData service.
ParseException
- error parsing the returned
entry.
ResourceNotFoundException
- if the entry URL is
not valid.
ServiceForbiddenException
- if the GData
service cannot get the entry resource due to access constraints.
ServiceException
- if a system error occurred when retrieving the
entry.public <E extends BaseEntry<?>> E getEntry(java.net.URL entryUrl, java.lang.Class<E> entryClass, DateTime ifModifiedSince) throws java.io.IOException, ServiceException
entryUrl
- resource URL for the entry.entryClass
- class used to represent service entries.ifModifiedSince
- used to set a precondition date that indicates the
entry should be returned only if it has been modified after the
specified date. A value of null
indicates no precondition.
java.io.IOException
- error communicating with the GData service.
NotModifiedException
- if the entry resource
has not been modified after the specified precondition date.
ParseException
- error parsing the returned
entry.
ResourceNotFoundException
- if the entry URL is
not valid.
ServiceForbiddenException
- if the GData
service cannot get the entry resource due to access constraints.
ServiceException
- if a system error occurred when retrieving the
entry.public <E extends BaseEntry<?>> E getEntry(java.net.URL entryUrl, java.lang.Class<E> entryClass, java.lang.String etag) throws java.io.IOException, ServiceException
entryUrl
- resource URL for the entry.entryClass
- class used to represent service entries.etag
- used to provide an entity tag that indicates the entry should
be returned only if the entity tag of the current representation is
different from the provided value. A value of null
indicates
unconditional return.
java.io.IOException
- error communicating with the GData service.
NotModifiedException
- if the entry resource entity tag matches the
provided value.
ParseException
- error parsing the returned
entry.
ResourceNotFoundException
- if the entry URL is
not valid.
ServiceForbiddenException
- if the GData
service cannot get the entry resource due to access constraints.
ServiceException
- if a system error occurred when retrieving the
entry.public Service.GDataRequest createEntryRequest(java.net.URL entryUrl) throws java.io.IOException, ServiceException
entryUrl
- resource URL for the entry.
java.io.IOException
- error communicating with the GData service.
ServiceException
- entry request creation failed.public <F extends BaseFeed<?,?>> F query(Query query, java.lang.Class<F> feedClass) throws java.io.IOException, ServiceException
Feed
containing entries that match the query result.
query
- Query instance defining target feed and query parameters.feedClass
- the Class used to represent a service Feed.
java.io.IOException
- error communicating with the GData service.
ServiceForbiddenException
- feed does not
support the query.
ParseException
- error parsing the returned
feed data.
ServiceException
- query request failed.public <F extends BaseFeed<?,?>> F query(Query query, java.lang.Class<F> feedClass, DateTime ifModifiedSince) throws java.io.IOException, ServiceException
Feed
containing entries that match the query result, if it's been
modified since the specified date.
query
- Query instance defining target feed and query parameters.feedClass
- the Class used to represent a service Feed.ifModifiedSince
- used to set a precondition date that indicates the
query result feed should be returned only if contains entries that
have been modified after the specified date. A value of null
indicates no precondition.
java.io.IOException
- error communicating with the GData service.
NotModifiedException
- if the query resource
does not contain entries modified since the specified precondition
date.
ServiceForbiddenException
- feed does not
support the query.
ParseException
- error parsing the returned
feed data.
ServiceException
- query request failed.public <F extends BaseFeed<?,?>> F query(Query query, java.lang.Class<F> feedClass, java.lang.String etag) throws java.io.IOException, ServiceException
Feed
containing entries that match the query result if the etag
for the target feed does not match the provided value.
query
- Query instance defining target feed and query parameters.feedClass
- the Class used to represent a service Feed.etag
- used to provide an entity tag that indicates the query should be
be performed only if the entity tag of the current representation is
different from the provided value. A value of null
indicates
unconditional return.
java.io.IOException
- error communicating with the GData service.
NotModifiedException
- if the feed resource entity tag matches the
provided value.
ServiceForbiddenException
- feed does not
support the query.
ParseException
- error parsing the returned
feed data.
ServiceException
- query request failed.public <E extends BaseEntry<?>> E insert(java.net.URL feedUrl, E entry) throws java.io.IOException, ServiceException
Entry
into a feed associated
with the target service. It will return the inserted Entry, including any
additional attributes or extensions set by the GData server.
feedUrl
- the POST URI associated with the target feed.entry
- the new entry to insert into the feed.
java.io.IOException
- error communicating with the GData service.
ParseException
- error parsing the return entry
data.
ServiceForbiddenException
- the inserted Entry
has associated media content and can only be inserted using a media
service.
ServiceException
- insert request failed due to system error.BaseFeed.getEntryPostLink()
,
BaseFeed.insert(BaseEntry)
public <F extends BaseFeed<?,?>> F batch(java.net.URL feedUrl, F inputFeed) throws java.io.IOException, ServiceException, BatchInterruptedException
Feed
. It will return another feed that
describes what was done while executing these operations.
It is possible for one batch operation to fail even though other operations
have worked, so this method won't throw a ServiceException unless something
really wrong is going on. You need to check the entries in the returned
feed to know which operations succeeded and which operations failed (see
BatchStatus
and
BatchInterrupted
extensions.)
feedUrl
- the POST URI associated with the target feed.inputFeed
- a description of the operations to execute, described
using tags in the batch: namespace
java.io.IOException
- error communicating with the GData service.
ParseException
- error parsing the return entry
data.
ServiceException
- insert request failed due to system error.
BatchInterruptedException
- if something really wrong was detected by
the server while parsing the request, like invalid XML data. Some
operations might have succeeded when this exception is thrown.
Check BatchInterruptedException.getFeed()
.BaseFeed.getEntryPostLink()
,
BaseFeed.insert(BaseEntry)
public Service.GDataRequest createInsertRequest(java.net.URL feedUrl) throws java.io.IOException, ServiceException
feedUrl
- the POST URI associated with the target feed.
java.io.IOException
- error reading from or writing to the GData service.
ServiceException
- insert request failed.public Service.GDataRequest createBatchRequest(java.net.URL feedUrl) throws java.io.IOException, ServiceException
feedUrl
- the POST URI associated with the target feed.
java.io.IOException
- error reading from or writing to the GData service.
ServiceException
- insert request failed.public <E extends BaseEntry<?>> E update(java.net.URL entryUrl, E entry) throws java.io.IOException, ServiceException
Entry
by writing it to
the specified entry edit URL. The resulting Entry (after update) will be
returned.
entryUrl
- the edit URL associated with the entry.entry
- the modified Entry to be written to the server.
java.io.IOException
- error communicating with the GData service.
ParseException
- error parsing the updated
entry data.
ServiceException
- update request failed due to system error.BaseEntry.getEditLink()
,
BaseEntry.update()
public <E extends BaseEntry<?>> E update(java.net.URL entryUrl, E entry, java.lang.String etag) throws java.io.IOException, ServiceException
Entry
by writing it to
the specified entry edit URL. The resulting Entry (after update) will be
returned. This update is conditional upon the provided tag matching the
current entity tag for the entry. If (and only if) they match, the update
will be performed.
entryUrl
- the edit URL associated with the entry.entry
- the modified Entry to be written to the server.etag
- the entity tag value that is the expected value for the target
resource. A value of null
will not set an etag
precondition and a value of "*"
will perform an
unconditional update.
java.io.IOException
- error communicating with the GData service.
PreconditionFailedException
- if the resource entity tag does not
match the provided value.
ParseException
- error parsing the updated
entry data.
ServiceException
- update request failed due to system error.BaseEntry.getEditLink()
,
BaseEntry.update()
public Service.GDataRequest createUpdateRequest(java.net.URL entryUrl) throws java.io.IOException, ServiceException
entryUrl
- the edit URL associated with the entry.
java.io.IOException
- error communicating with the GData service.
ServiceException
- creation of update request failed.public void delete(java.net.URL resourceUrl) throws java.io.IOException, ServiceException
resourceUrl
- the edit or medit edit url associated with the resource.
java.io.IOException
- error communicating with the GData service.
ResourceNotFoundException
- invalid entry URL.
ServiceException
- delete request failed due to system error.public void delete(java.net.URI resourceUri) throws java.io.IOException, ServiceException
resourceUri
- the edit or medit edit URI associated with the resource.
java.io.IOException
- error communicating with the GData service.
ResourceNotFoundException
- invalid entry URI.
ServiceException
- delete request failed due to system error.public void delete(java.net.URL resourceUrl, java.lang.String etag) throws java.io.IOException, ServiceException
resourceUrl
- the edit or medit edit url associated with the resource.etag
- the entity tag value that is the expected value for the target
resource. A value of null
will not set an etag
precondition and a value of "*"
will perform an
unconditional delete.
java.io.IOException
- error communicating with the GData service.
ResourceNotFoundException
- invalid entry URL.
ServiceException
- delete request failed due to system error.public void delete(java.net.URI resourceUri, java.lang.String etag) throws java.io.IOException, ServiceException
resourceUri
- the edit or medit edit URI associated with the resource.etag
- the entity tag value that is the expected value for the target
resource. A value of null
will not set an etag
precondition and a value of "*"
will perform an
unconditional delete.
java.io.IOException
- error communicating with the GData service.
ResourceNotFoundException
- invalid entry URI.
ServiceException
- delete request failed due to system error.public Service.GDataRequest createDeleteRequest(java.net.URL entryUrl) throws java.io.IOException, ServiceException
entryUrl
- the edit URL associated with the entry.
java.io.IOException
- error communicating with the GData service.
ServiceException
- creation of delete request failed.protected void closeSource(ParseSource source) throws java.io.IOException
source
- Parse source.
java.io.IOException
public java.io.InputStream getStreamFromLink(Link link) throws java.io.IOException, ServiceException
java.io.IOException
ServiceException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |