External Resource

<servers>
    <server>
        <name>server1</name>
        ...
        <resources>
            <mail-source>
                <mail-entry>
                    <export-name>mailSource</export-name>
                    <mail-property>
                        <name>mail.smtp.auth</name>
                        <value>true</value>
                    </mail-property>
                </mail-entry>
            </mail-source>
        </resource>
    </server>
</servers>

http://www.foo.com

http://www.bar.com

<resources>
    <url-source>
        <url-entry>
            <export-name>PRIMARY_URL</export-name>
            <url>http://www.foo.com</url>
        </url-entry>
        <url-entry>
            <export-name>SECONDARY_URL</export-name>
            <url>http://www.bar.com</url>
        </url-entry>
    </url-source>
</resources>

package dog;

import java.util.Hashtable;
import javax.naming.Context;
import javax.naming.Name;
import javax.naming.spi.ObjectFactory;

public class DogFactory implements ObjectFactory {
    public DogFactory() {}

    public Object getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable<?, ?> environment)
        throws Exception {
        Dog dog = Dog.getInstance();
        System.out.println("Creating a dog whose name is " + dog.getName() + ",
and age is " + dog.getAge());
        return dog;
    }
}

package dog;

public class Dog implements java.io.Serializable {
    public static final String DOG_NAME = "wangwang";
    public static final int DOG_AGE = 1;

    private static Dog instance = new Dog();

    private int age = DOG_AGE;
    private String name = DOG_NAME;

    public Dog() {}

    public static Dog getInstance() {
        return instance;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public boolean equals(Object anObject) {
        if (this == anObject) {
           return true;
        }
        if (anObject instanceof Dog) {
           Dog anotherDog = (Dog) anObject;
           return (this.age == anotherDog.age && this.name.equals(anotherDog.name));
        }
        return false;
    }

}

[MASTER]domain1.adminServer>add-custom-resource custom/dog -resource dog.Dog -factory dog.DogFactory
Successfully performed the ADD operation for A custom resource.
Check the results using "list-custom-resources or add-custom-resource"

[MASTER]domain1.adminServer>list-custom-resources
List of Custom Resources
================================================================================
+-------------+--------------------+--------------------------+----------------+
| Export Name |   Resource Class   |       Factory Class      |   Properties   |
+-------------+--------------------+--------------------------+----------------+
| custom/dog  | dog.Dog            | dog.DogFactory           | [test=1,       |
|             |                    |                          |test1=2]        |
+-------------+--------------------+--------------------------+----------------+
================================================================================

[MASTER]domain1.adminServer>add-custom-resource-to-servers custom/dog -servers server1
Successfully performed the ADD operation for A custom resource.
Check the results using "list-custom-resources"

[MASTER]domain1.adminServer>remove-custom-resource custom/dog
Successfully performed the REMOVE operation for A custom resource.
Check the results using "list-custom-resources or remove-custom-resource"

[MASTER]domain1.adminServer>list-custom-resources
List of Custom Resources
================================================================================
+-------------+--------------------+--------------------------+----------------+
| Export Name |   Resource Class   |       Factory Class      |   Properties   |
+-------------+--------------------+--------------------------+----------------+
(No data available)
================================================================================

<resources>
    <external-source>
        <jms-source>
            <vendor>ibmmq</vendor>
            <factory-class-name>FirstClassName</factory-class-name>
            <resource-type>QCF</resource-type>
            <export-name>exportName</export-name>
            <queue>MQ</queue>
            <queueManager>MQManager</queueManager>
        </jms-source>
    </external-source>
</resources>

<resources>
    <external-source>
        <connector>
            <resource-adapter-module-id>connectorModuleId</resource-adapter-module-id>
            <worker-pool>
                <min>0</min>
                <max>5</max>
                <keep-alive-time>60000</keep-alive-time>
                <queue-size>4096</queue-size>
                <shutdown-timeout>-1</shutdown-timeout>
            </worker-pool>
        </connector>
    </external-source>
</resources>

package jeus.external;

import javax.naming.Context;
import java.util.Map;

/**
 * A bootstrapper to use external resources in JEUS.
 */
public interface ResourceBootstrapper {
    /**
     *
     * @param propertyMap A Map with resource settings.
     */
    void setProperties(Map propertyMap) throws InvalidPropertyException;

    /**
     * Binds a resource.
     * @param context
     */
    void initResources(Context context);

    /**
     * Returns information about available properties.
     * @return
     */
    ResourcePropertyInfo[] getPropertyInfo();

    /**
     *
     * @param propertyMap A map with properties to be modified.
     */
    void modifyProperties(Map propertyMap) throws InvalidPropertyException;

    /**
     * To be called when re-binding the resource.
     * @param context
     */
    void reconfigResources(Context context);

    /**
     * Removes the resource.
     * @param context
     */
    void destroyResources(Context context);
}

[MASTER]domain1.adminServer>add-external-resource test/ext -resource test.ext.TestResourceBootstrapper
Successfully performed the ADD operation for A external resource.
Check the results using "list-external-resources or add-external-resource"

[MASTER]domain1.adminServer>list-external-resources
List of External Resources
=============================================================================
+----------+---------------------------------------------------+------------+
| Name     |                   Resource Class                  | Properties |
+----------+---------------------------------------------------+------------+
| test/ext | test.ext.TestResourceBootstrapper                 | []         |
+----------+---------------------------------------------------+------------+
=============================================================================

[MASTER]domain1.adminServer>add-external-resource-to-servers test/ext -servers server1
Successfully performed the ADD operation for A external resource.
Check the results using "list-external-resources"

[MASTER]domain1.adminServer>remove-external-resource test/ext
Successfully performed the REMOVE operation for A external resource.
Check the results using "list-external-resources or remove-external-resource"

[MASTER]domain1.adminServer>list-external-resources
List of External Resources
=========================================================================
+------+---------------------------------------------------+------------+
| Name |                   Resource Class                  | Properties |
+------+---------------------------------------------------+------------+
(No data available)
=========================================================================