Deprecated API


Contents
Deprecated Classes
com.google.gdata.data.extensions.ContactEntry
          Please use ContactEntry instead. 
com.google.gdata.data.extensions.ContactFeed
          Please use ContactFeed instead. 
com.google.gdata.util.httputil.FastURLEncoder
          Use CharEscapers.uriEscaper(), CharEscapers.cppUriEscaper() or create your own custom PercentEscaper.

Almost every use of FastURLEncoder can now be replaced with an instance of the PercentEscaper class, which is much faster.

In most cases it should be possible to use the static instances available from CharEscapers but it is also possible to create your own escaper with custom behaviour.

See Deprecating FastURLEncoder for more information.

Note that the new uriEscaper only escapes using UTF-8 encoding and while no examples of other encodings were found when preparing this class for deprecation, it's possible that some instance were missed. If you have a valid reason to escape URIs via an encoding other than UTF-8 please let the java-libraries-team know.

FastURLEncoder is intended as a replacement for the slow and inefficient java.net.URLEncoder. There are a few differences though:

  • URLEncoder.encode(String) uses the platform's default encoding while FastURLEncoder.encode(String) always uses UTF-8. The default encoding is unpredictable and so it shouldn't be used anyway.
  • FastURLEncoder allocates much less memory. In my tests I escaped 81735 bytes of data 20 bytes at a time. URLEncoder allocated over 200 MB! FastURLEncoder allocated much less (probably about 500 kB).
  • FastURLEncoder is over 30 times as fast.
  • FastURLEncoder (optionally) lets you specify which octets should and shouldn't be escaped and also whether spaces should be escaped as "+" or "%20".

It is possible that URLEncoder is doing really complicated stuff for a reason and that I just don't understand why. If you are unsure of FastURLEncoder just call FastURLEncoder.setVerifyAgainstJava(true). This will run both versions and verify that the outputs are the same. Of course this will be slow but it is useful for testing. I wouldn't be surprised if the two differ for non-latin1, non-utf-8 encodings.

FastURLEncoder requires jdk 1.5. 

com.google.gdata.data.extensions.GeoPt
          Use com.google.gdata.data.geo.impl package. 
com.google.gdata.data.photos.impl.GphotoDataImpl.GphotoRssLink
          Clients should modify the alt-type themselves to request RSS. 
com.google.gdata.data.photos.impl.GphotoDataImpl.GphotoType
          Clients should use the atom:category to discover the kind of an item. 
com.google.gdata.data.photos.pheed.Namespaces
          the pheed namespace is deprecated in favor of media rss. 
com.google.gdata.data.photos.pheed.PheedConstruct
          the pheed construct is deprecated in favor of media rss. 
com.google.gdata.data.photos.pheed.PheedImageUrl
          the pheed namespace is deprecated in favor of media rss. 
com.google.gdata.data.photos.pheed.PheedThumbnail
          the pheed namespace is deprecated in favor of media rss. 
com.google.gdata.data.photos.pheed.PheedVideoUrl
          the pheed namespace is deprecated in favor of media rss. 
com.google.gdata.data.photos.impl.PhotoDataImpl.GphotoExifTime
          use ExifTags instead. 
com.google.gdata.util.common.xml.XmlWriter.Namespace
          Use the XmlNamespace class instead. 
com.google.gdata.data.youtube.YtDescription
          This tag is only accepted in version 1 of the protocol. The tag atom:summary usually replaces yt:description in version 2 and later. 
com.google.gdata.data.youtube.YtRacy
          in favor of MediaRating with YouTubeNamespace.MEDIA_RATING_SCHEME. 
 

Deprecated Fields
com.google.gdata.util.Namespaces.atomPub
          Use getAtomPubNs().getUri() instead. 
com.google.gdata.util.Namespaces.atomPubNs
          Use Namespaces.getAtomPubNs() instead. 
com.google.gdata.util.Namespaces.atomPubStandard
          Use getAtomPubNs().getUri() instead. 
com.google.gdata.util.Namespaces.atomPubStandardNs
          Use Namespaces.getAtomPubNs() instead. 
com.google.gdata.util.httputil.FastURLEncoder.CPLUSPLUS_COMPAT_SAFE_OCTETS
          Use CharEscapers.cppUriEscaper() 
com.google.gdata.data.Link.Rel.MEDIA_EDIT_BACKCOMPAT
          use Link.Rel.MEDIA_EDIT instead. 
com.google.gdata.client.http.HttpGDataRequest.METHOD_OVERRIDE_HEADER
          Use GDataProtocol.Header#METHOD_OVERRIDE instead 
com.google.gdata.util.Namespaces.openSearch
          Use getOpenSearchNs().getUri() instead. 
com.google.gdata.util.Namespaces.openSearch1_1
          Use getOpenSearchNs().getUri() instead. 
com.google.gdata.util.Namespaces.openSearch1_1Ns
          Use Namespaces.getOpenSearchNs() instead. 
com.google.gdata.util.Namespaces.openSearchDesc
          Use getOpenSearchDescNs().getUri() instead. 
com.google.gdata.util.Namespaces.openSearchDesc1_1
          Use getOpenSearchDescNs().getUri() instead. 
com.google.gdata.util.Namespaces.openSearchDesc1_1Ns
          Use Namespaces.getOpenSearchDescNs() instead. 
com.google.gdata.util.Namespaces.openSearchDescNs
          Use Namespaces.getOpenSearchDescNs() instead. 
com.google.gdata.util.Namespaces.openSearchNs
          Use Namespaces.getOpenSearchNs() instead. 
 

Deprecated Methods
com.google.api.gbase.client.GmAttributes.addAttribute(String, GoogleBaseAttributeType)
          use GmAttributes.addAttribute(GoogleBaseAttributeId, GmAttribute.Importance) instead. This method will be removed in a future release 
com.google.gdata.util.common.base.StringUtil.Collection2String(Collection, String)
          Please use But note that Join does not consider null elements to be equivalent to the empty string, as this method does. 
com.google.gdata.util.common.base.StringUtil.convertEOLToCRLF(String)
          Please inline this method. 
com.google.gdata.data.ExtensionProfile.declareEntryExtension(Class)
          Calls to this API should be replaced with calls to ExtensionProfile.declare(Class,ExtensionDescription) where the first argument is a specific BaseEntry subtype. The BaseEntry class should only be used for mix-in types that might appear in multiple entry types. Its use for all entry declarations can result in conflicts when mutiple feed types are declared into a single extension profile, a common practice in client library service initialization for services that return multiple entry types. 
com.google.gdata.data.ExtensionProfile.declareEntryExtension(ExtensionDescription)
          Calls to this API should be replaced with calls to ExtensionProfile.declare(Class,ExtensionDescription) where the first argument is a specific BaseEntry subtype. The BaseEntry class should only be used for mix-in types that might appear in multiple entry types. Its use for all entry declarations can result in conflicts when mutiple feed types are declared into a single extension profile, a common practice in client library service initialization for services that return multiple entry types. 
com.google.gdata.data.ExtensionProfile.declareFeedExtension(Class)
          Calls to this API should be replaced with calls to ExtensionProfile.declare(Class,ExtensionDescription) where the first argument is a specific BaseFeed subtype. The BaseFeed class should only be used for mix-in types that might appear in multiple feed types. Its use for all feed declarations can result in conflicts when mutiple feed types are declared into a single extension profile, a common practice in client library service initialization for services that return multiple feed types. 
com.google.gdata.data.ExtensionProfile.declareFeedExtension(ExtensionDescription)
          Calls to this API should be replaced with calls to ExtensionProfile.declare(Class,ExtensionDescription) where the first argument is a specific BaseFeed subtype. The BaseFeed class should only be used for mix-in types that might appear in multiple feed types. Its use for all feed declarations can result in conflicts when mutiple feed types are declared into a single extension profile, a common practice in client library service initialization for services that return multiple feed types. 
com.google.gdata.util.httputil.FastURLEncoder.encode(String)
          Use CharEscapers.uriEscaper(). 
com.google.gdata.util.httputil.FastURLEncoder.encode(String, Appendable)
          Use CharEscapers.uriEscaper(). See FastURLEncoder for more details. 
com.google.gdata.util.httputil.FastURLEncoder.encode(String, BitSet, boolean)
          Use CharEscapers.uriEscaper(). or create an instance of PercentEscaper. See FastURLEncoder for more details. 
com.google.gdata.util.httputil.FastURLEncoder.encode(String, String)
          Use CharEscapers.uriEscaper(). See FastURLEncoder for more details. 
com.google.gdata.util.httputil.FastURLEncoder.encode(String, String, Appendable)
          Use CharEscapers.uriEscaper(). See FastURLEncoder for more details. 
com.google.gdata.util.httputil.FastURLEncoder.encode(String, String, BitSet, boolean)
          Use CharEscapers.uriEscaper() or create an instance of PercentEscaper. See FastURLEncoder for more details. 
com.google.gdata.util.httputil.FastURLEncoder.encode(String, String, BitSet, boolean, Appendable)
          Use CharEscapers.uriEscaper() or create an instance of PercentEscaper. See FastURLEncoder for more details. 
com.google.api.gbase.client.GmAttributes.getAttributeIds()
          use GmAttributes.getAttributes() instead. 
com.google.api.gbase.client.ItemTypeDescription.getAttributeIds()
          use ItemTypeDescription.getAttributes() instead 
com.google.gdata.data.youtube.VideoMessageEntry.getDescription()
          Valid only in version 1. Replaced version 2.0 with atom:summary. 
com.google.gdata.data.youtube.UserProfileEntry.getDescription()
          Valid only in version 1. Replaced in version 2.0 with yt:aboutMe for the user self description and atom:summary for the user channel description 
com.google.gdata.data.youtube.PlaylistEntry.getDescription()
          Valid only in version 1. Replaced version 2.0 with atom:summary. 
com.google.gdata.data.youtube.FeedLinkEntry.getDescription()
          Valid only in version 1. Replaced in version 2.0 with atom:summary. 
com.google.gdata.data.youtube.FeedLinkEntry.getFeedLink()
          Starting with version 2, the feed link can be found in the content. See FeedLinkEntry.getFeedUrl() and FeedLinkEntry.getCountHint(). 
com.google.gdata.data.photos.impl.AlbumDataImpl.getImageUrl()
          use the media:content element to get the image source. 
com.google.gdata.client.youtube.YouTubeQuery.getIncludeRacy()
          Please use YouTubeQuery.getSafeSearch() instead. 
com.google.gdata.data.photos.impl.AlbumDataImpl.getThumbnail()
          use the media:thumbnail element to get thumbnails. 
com.google.gdata.client.youtube.YouTubeQuery.getVideoQuery()
          Please use Query.getFullTextQuery() instead. 
com.google.gdata.data.youtube.VideoEntry.isRacy()
          in favor of MediaGroup#getRatings() with scheme YouTubeNamespace.MEDIA_RATING_SCHEME. Removed in version 2 
com.google.gdata.util.common.base.StringUtil.Iterator2String(Iterator, String)
          Please use But note that Join does not consider null elements to be equivalent to the empty string, as this method does. 
com.google.gdata.util.common.base.StringUtil.join(Collection, String)
          Please use But note that Join does not consider null elements to be equivalent to the empty string, as this method does. 
com.google.gdata.util.common.base.StringUtil.join(Object[], String)
          Please use But note that Join does not consider null elements to be equivalent to the empty string, as this method does. 
com.google.gdata.util.common.base.StringUtil.list2String(Collection, String)
          Please use But note that Join does not consider null elements to be equivalent to the empty string, as this method does. 
com.google.gdata.util.common.base.StringUtil.lstrip(String)
          ensure the string is not null and use CharMatcher.LEGACY_WHITESPACE.trimLeadingFrom(str); also consider whether you really want the legacy whitespace definition, or something more standard like CharMatcher.WHITESPACE. 
com.google.gdata.util.common.base.StringUtil.megastrip(String, boolean, boolean, String)
          ensure the string is not null and use
  • CharMatcher.anyOf(what).trimFrom(str) if left == true and right == true
  • CharMatcher.anyOf(what).trimLeadingFrom(str) if left == true and right == false
  • CharMatcher.anyOf(what).trimTrailingFrom(str) if left == false and right == true
 
com.google.gdata.util.common.base.StringUtil.replace(String, String, String)
          Please use String.replace(CharSequence, CharSequence). 
com.google.gdata.util.common.base.StringUtil.rstrip(String)
          ensure the string is not null and use CharMatcher.LEGACY_WHITESPACE.trimTrailingFrom(str); also consider whether you really want the legacy whitespace definition, or something more standard like CharMatcher.WHITESPACE. 
com.google.gdata.data.youtube.VideoMessageEntry.setDescription(String)
          Valid only in version 1. Replaced version 2.0 with atom:summary. 
com.google.gdata.data.youtube.UserProfileEntry.setDescription(String)
          Valid only in version 1. Replaced in version 2.0 with yt:aboutMe for the user self description and atom:summary for the user channel description 
com.google.gdata.data.youtube.PlaylistEntry.setDescription(String)
          Valid only in version 1. Replaced version 2.0 with atom:summary. 
com.google.gdata.data.youtube.FeedLinkEntry.setDescription(String)
          Valid only in version 1. Replaced in version 2.0 with atom:summary. 
com.google.gdata.data.youtube.FeedLinkEntry.setFeedLink(FeedLink)
          Starting with version 2, the feed link can be found in the content. 
com.google.gdata.data.docs.DocumentListEntry.setFile(File)
          Prefer setFile(File, String) 
com.google.gdata.data.photos.impl.AlbumDataImpl.setImageUrl(String)
          set the media:content element with the image source. 
com.google.gdata.client.youtube.YouTubeQuery.setIncludeRacy(Boolean)
          Please use #setSafeSearch(String) instead. 
com.google.gdata.data.youtube.VideoEntry.setRacy(boolean)
          in favor of MediaGroup#getRatings() with scheme YouTubeNamespace.MEDIA_RATING_SCHEME. Removed in version 2. 
com.google.gdata.data.photos.impl.AlbumDataImpl.setThumbnail(String)
          use the media:thumbnail element to set thumbnails. 
com.google.gdata.client.youtube.YouTubeQuery.setVideoQuery(String)
          Please use Query#setFullTextQuery() instead. 
 

Deprecated Constructors
com.google.gdata.util.common.xml.XmlWriter(Writer, boolean)
          see XmlWriter.XmlWriter(Writer, Set, String) 
 

Deprecated Enum Constants
com.google.gdata.client.youtube.YouTubeQuery.OrderBy.UPDATED
          use YouTubeQuery.OrderBy.PUBLISHED instead.