Sinobu

This is a marker interface for Extension Point of your application.

All Extension Points are recognized automatically by Sinobu if you use I#load(Class) or I#load(java.net.URL) methods properly. And an Extension Point will provide some Extensions.

What is Extension Point?

We give a definition of Extension Point like the following.

• It implements Extensible interface.
• It has Extensible interface in not ancestor but parent.

interface ThisIsExtensionPoint extends Extensible {
}

interface ThisIsNotExtensionPoint implements ThisIsExtensionPoint {
}

class ThisIsAlsoExtensionPoint implements Extensible {
    // This is both Extension Point and Extension.
}

What is Extension?

We give a definition of Extension like the following.

• It implements any Extension Point or is Extension Point itself.
• It must be concrete class and has a suitable constructor for Sinobu (see also I#make(Class) method).

class ThisIsExtension implements Extensible {
    // This is both Extension Point and Extension.
}

class ThisIsAlsoExtension extends ThisIsExtension {
    // But not Extension Point.
}

class ThisIsNotExtension extends ThisIsExtension {

    public ThisIsNotExtension(NotInjectable object) {
        // because of invalid constructor
    }
}

What is Extension Key?

You can provide Extension Key for each Extensions by using parameter. The key makes easy finding an Extension you need (see also I#find(Class, Class)).

interface ExtensionPointWithKey<K> extends Extensible {
}

class ExtensionWithKey implements ExtensionPointWithKey<String> {
    // Associate this Extension with String class.
}

class ExtensionWithAnotherKey implements ExtensionPointWithKey<List> {
    // Associate this Extension with List interface.
}