Quick Start (EJB mode): Creating relationships between resources using the Java API

The following Java code example creates a relationship between two resources in the LiveCycle repository. (See Creating Resource Relationships.)

/* 
    * This Java Quick Start uses the following JAR files 
    * 1. adobe-repository-client.jar 
    * 2. adobe-livecycle-client.jar 
    * 3. adobe-usermanager-client.jar 
    * 4. adobe-utilities.jar 
    * 5. jbossall-client.jar (use a different JAR file if the LiveCycle server is not deployed 
    * on JBoss) 
    * 6. commons-code-1.3.jar 
    * 7. jacorb.jar (use a different JAR file if the LiveCycle server is not deployed on JBoss) 
    * 8. jnp-client.jar (use a different JAR file if the LiveCycle server is not deployed on JBoss) 
    *  
    *  The JBoss files must be kept in the jboss\client folder. You can copy the client folder to  
    *  your local development environment and then include the 3 JBoss JAR files in your class path 
    *   
    *  These JAR files are located in the following path: 
    * <install directory>/sdk/client-libs/common 
    *  
    * The adobe-utilities.jar file is located in the following path: 
    * <install directory>/sdk/client-libs/jboss 
    *  
    * The jbossall-client.jar file is located in the following path: 
    * <install directory>/jboss/client 
    *  
    * If you want to invoke a remote LiveCycle server instance and there is a 
    * firewall between the client application and the server, then it is  
    * recommended that you use the SOAP mode. When using the SOAP mode,  
    * you have to include additional JAR files located in the following  
    * path 
    * <install directory>/sdk/client-libs/thirdparty 
    *  
    * For information about the SOAP  
    * mode and the additional JAR files that need to be included,  
    * see "Setting connection properties" in Programming  
    * with LiveCycle 
    *  
    * For complete details about the location of the LiveCycle JAR files,  
    * see "Including LiveCycle Java library files" in Programming  
    * with LiveCycle 
    */ 
import java.util.*; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties; 
import com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient; 
import com.adobe.repository.infomodel.*; 
import com.adobe.repository.infomodel.bean.*; 
 
public class CreateRelationship { 
 
    public static void main(String[] args) { 
 
        // This example creates a relationship between two resources in the LiveCycle ES4 repository. 
        // First, two resources are created. 
        // A dependence relationship between the two resources will then be established and verified. 
        try  
        { 
            //Set connection properties required to invoke LiveCycle                                 
            Properties connectionProps = new Properties(); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://hiro-xp:1099"); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);           
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss"); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator"); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password"); 
             
            // Create the service client factory 
            ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps); 
             
            // Create a ResourceRepositoryClient object using the service client factory 
            ResourceRepositoryClient repositoryClient = new ResourceRepositoryClient(myFactory); 
 
            // Create a RepositoryInfomodelFactoryBean needed for creating resources 
            RepositoryInfomodelFactoryBean repositoryInfomodelFactory = new RepositoryInfomodelFactoryBean(null); 
 
            // Specify the URI of the target folder for writing the resource 
            String testFolderUri = "/Applications/FormsApplication/1.0/FormsFolder"; 
 
            // Create the resources to be written to the folder 
            Resource testResource1 = repositoryInfomodelFactory.newResource( 
                new Id(),  
                new Lid(),  
                "FormFolderA" 
            ); 
 
            Resource testResource2 = repositoryInfomodelFactory.newResource( 
                new Id(), 
                new Lid(), 
                "FormFolderB" 
            ); 
 
            // Set the resources' descriptions 
            testResource1.setDescription("test resource1"); 
            testResource2.setDescription("test resource2"); 
 
            // Write the resources to the folder 
            repositoryClient.writeResource(testFolderUri, testResource1); 
            repositoryClient.writeResource(testFolderUri, testResource2); 
 
            // Retrieve the resources' URIs 
            String resourceUri1 = testFolderUri + "/" + testResource1.getName(); 
            String resourceUri2 = testFolderUri + "/" + testResource2.getName(); 
 
            // Retrieve the resources to verify that they were successfully written 
            Resource r1 = repositoryClient.readResource(resourceUri1); 
            Resource r2 = repositoryClient.readResource(resourceUri2); 
 
            // Create a relationship between the two resources 
            repositoryClient.createRelationship( 
                resourceUri1,  
                resourceUri2,  
                Relation.TYPE_DEPENDANT_OF,  
                true 
            ); 
 
            // Verify the relationship 
            List relations = repositoryClient.getRelated( 
                resourceUri1,  
                true,  
                Relation.TYPE_DEPENDANT_OF 
            ); 
 
            // Print the relationship 
            for (int i = 0; i < relations.size(); i++) { 
                Resource r = (Resource)(relations.get(i)); 
                System.out.println("Related resource: " + r.getName()); 
            } 
 
        } catch (Exception e) { 
            System.out.println( 
                "Exception thrown while trying to create the relationship" + 
                e.getMessage() 
            ); 
        } 
    } 
}