Examples of com.google.gdata.util.VersionRegistry

com.google.gdata.util.VersionRegistry
The VersionRegistry class is used to manage and retrieve version information about executing services. The registry supports the ability to configure versions for a running thread (via the {@link #setThreadVersion(Version)}method) or global defaults that will apply to all threads (using the {@link #addDefaultVersion(Version,boolean)} method. Thread defaults willhave precedence over global defaults if present for the same service. The class provides a singleton instance that is being used to manage version information. This instance is initialized by the {@link #ensureRegistry()}method. The active VersionRegistry instance can be retrieved using the {@link #get()} method. This method will throw an{@link IllegalStateException} if the version registry has not beeninitialized to aid in the detection of when version-conditional code is being executed in an environment where versions have net been configured. The {@link VersionRegistry#getVersion(Class)} method can be used to requestthe version information for a particular service. A model for writing version conditional code based upon the registry is: Version myServiceVersion = VersionRegistry.get().getVersion(MyService.class); if (myServiceVersion.isCompatible(MyService.VERSIONS.V1) { ... execute V1-specific handling ... } VersionRegistry access is thread-safe.

   * @param defaultVersion the service version expected by this client library.
   */
  protected static Version initServiceVersion(
      Class<? extends Service> serviceClass, Version defaultVersion) {


    VersionRegistry versionRegistry = VersionRegistry.ensureRegistry();
    Version v = null;
    try {
      // Check to see if default has already been defined
      v = versionRegistry.getVersion(serviceClass);
    } catch (IllegalStateException ise) { 
      // If not, use system property override or provided default version
      try {
        v = VersionRegistry.getVersionFromProperty(serviceClass);
      } catch (SecurityException e) {
        // Ignore exception, and just take default.
      }
      if (v == null) {
        v = defaultVersion;
      }
      // Do not include any implied versions, which are defaulted separately
      // by their own service static initialization.
      versionRegistry.addDefaultVersion(v, false);
    }
    return v;
  }

View Full Code Here

    // Find the service type with a declared default version that is
    // closest to the requested service type. Walking up the class hierarchy
    // allows for the possibility of subclassing without defining a different
    // protocol type
    Class<? extends Service> checkClass = serviceClass;
    VersionRegistry registry = VersionRegistry.get();
    while (checkClass != Service.class) {
      try {
        return registry.getVersion(checkClass);
      } catch (IllegalStateException ise) {
        checkClass = (Class<? extends Service>) checkClass.getSuperclass();
      }
    }

View Full Code Here

   * @param defaultVersion the service version expected by this client library.
   */
  protected static Version initServiceVersion(
      Class<? extends Service> serviceClass, Version defaultVersion) {


    VersionRegistry versionRegistry = VersionRegistry.ensureRegistry();
    Version v = null;
    try {
      // Check to see if default has already been defined
      v = versionRegistry.getVersion(serviceClass);
    } catch (IllegalStateException ise) {
      // If not, use system property override or provided default version
      try {
        v = VersionRegistry.getVersionFromProperty(serviceClass);
      } catch (SecurityException e) {
        // Ignore exception, and just take default.
      }
      if (v == null) {
        v = defaultVersion;
      }
      // Do not include any implied versions, which are defaulted separately
      // by their own service static initialization.
      versionRegistry.addDefaultVersion(v, false);
    }
    return v;
  }

View Full Code Here

    // Find the service type with a declared default version that is
    // closest to the requested service type. Walking up the class hierarchy
    // allows for the possibility of subclassing without defining a different
    // protocol type
    Class<? extends Service> checkClass = serviceClass;
    VersionRegistry registry = VersionRegistry.get();
    while (checkClass != Service.class) {
      try {
        return registry.getVersion(checkClass);
      } catch (IllegalStateException ise) {
        checkClass = (Class<? extends Service>) checkClass.getSuperclass();
      }
    }

View Full Code Here

TOP

Related Classes of com.google.gdata.util.VersionRegistry

com.google.gdata.client.Service

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.