Examples of javax.imageio.spi.ServiceRegistry

javax.imageio.spi.ServiceRegistry
A registry for service provider instances.
A service is a well-known set of interfaces and (usually abstract) classes. A service provider is a specific implementation of a service. The classes in a provider typically implement the interface or subclass the class defined by the service itself.
Service providers are stored in one or more categories, each of which is defined by a class of interface (described by a Class object) that all of its members must implement. The set of categories may be changed dynamically.
Only a single instance of a given leaf class (that is, the actual class returned by getClass(), as opposed to any inherited classes or interfaces) may be registered. That is, suppose that the com.mycompany.mypkg.GreenServiceProvider class implements the com.mycompany.mypkg.MyService interface. If a GreenServiceProvider instance is registered, it will be stored in the category defined by the MyService class. If a new instance of GreenServiceProvider is registered, it will replace the previous instance. In practice, service provider objects are usually singletons so this behavior is appropriate.
To declare a service provider, a services subdirectory is placed within the META-INF directory that is present in every JAR file. This directory contains a file for each service provider interface that has one or more implementation classes present in the JAR file. For example, if the JAR file contained a class named com.mycompany.mypkg.MyServiceImpl which implements the javax.someapi.SomeService interface, the JAR file would contain a file named:
```
 META-INF/services/javax.someapi.SomeService 
```
containing the line:
```
 com.mycompany.mypkg.MyService 
```
The service provider classes should be to be lightweight and quick to load. Implementations of these interfaces should avoid complex dependencies on other classes and on native code. The usual pattern for more complex services is to register a lightweight proxy for the heavyweight service.
An application may customize the contents of a registry as it sees fit, so long as it has the appropriate runtime permission.
For more details on declaring service providers, and the JAR format in general, see the JAR File Specification. @see RegisterableService

  implements Testlet
{
  public void test(TestHarness h)
  {
    Throwable caught;
    ServiceRegistry registry;
    SomeService s1 = new SomeService();
    TestService s2 = new TestService();


    List categories = new LinkedList();
    categories.add(SomeService.class);
    categories.add(RegisterableService.class);
    registry = new ServiceRegistry(categories.iterator());
    registry.registerServiceProvider(s1);
    registry.registerServiceProvider(s2);


    // Check #1: Null argument --> IllegalArgumentException.
    caught = null;
    try
      {
        registry.deregisterAll(null);
      }
    catch (Exception ex)
      {
        caught = ex;
      }
    h.check(caught instanceof IllegalArgumentException);


    // Check #2: Unregistered category --> IllegalArgumentException.
    caught = null;
    try
      {
        registry.deregisterAll(String.class);
      }
    catch (Exception ex)
      {
        caught = ex;
      }
    h.check(caught instanceof IllegalArgumentException);


    // Check #3: De-registered all SomeServices.
    registry.deregisterAll(SomeService.class);
    h.check(!registry.contains(s1));


    // Check #4: Did not de-register TestService.
    h.check(registry.contains(s2) && s2.numRegistrations == 1);
  }

View Full Code Here

  implements Testlet
{
  public void test(TestHarness h)
  {
    Throwable caught;
    ServiceRegistry registry;
    List categories;


    // Set-up.
    categories = new LinkedList();
    categories.add(String.class);
    categories.add(RegisterableService.class);
    registry = new ServiceRegistry(categories.iterator());
    registry.registerServiceProvider("foo", String.class);
    registry.registerServiceProvider("bar", String.class);


    // Check #1.
    caught = null;
    try
      {
        registry.getServiceProviderByClass(null);
      }
    catch (Exception ex)
      {
        caught = ex;
      }
    h.check(caught instanceof IllegalArgumentException);


    // Check #2.
    h.check(registry.getServiceProviderByClass(RegisterableService.class),
            null);


    // Check #3.
    Object sp = registry.getServiceProviderByClass(String.class);
    h.check(sp == "foo" || sp == "bar");
  }

View Full Code Here

  implements Testlet
{
  public void test(TestHarness h)
  {
    Throwable caught;
    ServiceRegistry registry;
    List categories;


    // Set-up.
    categories = new LinkedList();
    categories.add(String.class);
    categories.add(RegisterableService.class);
    registry = new ServiceRegistry(categories.iterator());
    registry.registerServiceProvider("sheep", String.class);
    registry.registerServiceProvider("goat", String.class);
    registry.registerServiceProvider("cow", String.class);


    // Check #1: Unknown category --> IllegalArgumentException.
    caught = null;
    try
      {
        registry.setOrdering(String.class, "foo",  null);
      }
    catch (Exception ex)
      {
        caught = ex;
      }
    h.check(caught instanceof IllegalArgumentException);


    // Check #2: Twice the same object --> IllegalArgumentException.
    caught = null;
    try
      {
        registry.setOrdering(String.class, "sheep", "sheep");
      }
    catch (Exception ex)
      {
        caught = ex;
      }
    h.check(caught instanceof IllegalArgumentException);


    // Check #3. Fails on JDK 1.4.1_01.
    h.check(registry.setOrdering(String.class, "cow", "sheep"));


    // Check #4. Fails on JDK 1.4.1_01.
    h.check(registry.setOrdering(String.class, "sheep", "goat"));


    // Check #5.
    h.check(!registry.setOrdering(String.class, "sheep", "goat"));


    // Check #6.
    h.check(!registry.setOrdering(String.class, "cow", "sheep"));


    // Check #7. Fails on JDK 1.4.1_01.
    h.check(registry.unsetOrdering(String.class, "cow", "sheep"));


    // Check #8.
    h.check(!registry.unsetOrdering(String.class, "cow", "sheep"));


    // Check #9. Fails on JDK 1.4.1_01.
    h.check(registry.setOrdering(String.class, "cow", "sheep"));
  }

View Full Code Here

public class getCategories
  implements Testlet
{
  public void test(TestHarness h)
  {
    ServiceRegistry registry;
    List categories;
    Set cats;


    // Check #1.
    registry = new ServiceRegistry(Collections.EMPTY_LIST.iterator());
    h.check(!registry.getCategories().hasNext());


    // Check #2, #3 and #4.
    categories = new LinkedList();
    categories.add(String.class);
    categories.add(RegisterableService.class);
    registry = new ServiceRegistry(categories.iterator());
    cats = new HashSet();
    for (Iterator iter = registry.getCategories(); iter.hasNext();)
      cats.add(iter.next());
    
    h.check(cats.size(), 2); // Check #2.
    h.check(cats.contains(String.class)); // Check #3.
    h.check(cats.contains(RegisterableService.class)); // Check #4.

View Full Code Here

TOP

Related Classes of javax.imageio.spi.ServiceRegistry

gnu.testlet.javax.imageio.spi.ServiceRegistry.deregisterAll

gnu.testlet.javax.imageio.spi.ServiceRegistry.getCategories

gnu.testlet.javax.imageio.spi.ServiceRegistry.getServiceProviderByClass

gnu.testlet.javax.imageio.spi.ServiceRegistry.registerServiceProvider

gnu.testlet.javax.imageio.spi.ServiceRegistry.setOrdering

java.io.InputStream

java.io.BufferedReader

java.io.InputStreamReader

java.util.List

java.util.ArrayList

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.