Configure new URL providers for application clients

Create URL providers and URLs for our client application using the Application Client Resource Configuration Tool (ACRCT).

During this task, we create URL providers and URLs for our client application. In a separate administrative task, install the Java code for the required URL provider on the client machine on which the client application resides.

Tasks

1. Start the Application Client Resource Configuration Tool (ACRCT).

2. Open the EAR file for which we want to configure the new URL provider. The EAR file contents display in a tree view.

3. Select the JAR file in which we want to configure the new URL provider from the tree.

4. Expand the JAR file to view the contents.

5. Click the folder called URL Providers. Complete one of the following actions:
   • Right click the folder and select New.

   • Click Edit > New on the menu bar.

6. Configure the URL provider properties in the resulting property dialog.

7. Click OK.

8. Click File > Save on the menu bar to save the changes.

Example

• Configure URL and URL provider settings for application clients

This code example illustrates how to configure URL and URL provider settings for application clients:

<resources.url:URLProvider xmi:id="URLProvider_1" name="urlProvider:name" 
description="urlProvider:description" 
streamHandlerClassName="urlProvider:streamHandlerClass" 
protocol="urlProvider:protocol">
<classpath>urlProvider:classpath</classpath>
<factories xmi:type="resources.url:URL" xmi:id="URL_1" name="urlFactory:name" 
jndiName="urlFactory:jndiName" description="urlFactory:description" 
spec="urlFactory:url">
<propertySet xmi:id="J2EEResourcePropertySet_18">
<resourceProperties xmi:id="J2EEResourceProperty_20" name="urlFactory:customName" 
value="urlFactory:customValue"/>
</propertySet>
</factories>
<propertySet xmi:id="J2EEResourcePropertySet_19">
<resourceProperties xmi:id="J2EEResourceProperty_21" name="urlProvider:customName" 
value="urlProvider:customValue"/>
</propertySet>
</resources.url:URLProvider>

• Required fields:
  • URL Properties page: name, jndiName, url
  • URL Provider Properties page: name

Subtopics

• URLs for application clients
  A URL is an identifier that points to an electronically accessible resource, such as a directory file on a machine in a network, or a document stored in a database.
• URL providers for the Application Client Resource Configuration Tool
  A URL provider implements the function for a particular URL protocol, such as HyperText Transfer Protocol (HTTP). This provider, comprised of a pair of classes, extends the java.net.URLStreamHandler and java.net.URLConnection classes.
• Configure URL providers and sessions using the Application Client Resource Configuration Tool
  We can edit the configurations of URL providers and URLs to be used by the application clients using the Application Client Resource Configuration Tool (ACRCT).
• Example: Configuring URL and URL provider settings for application clients
  We can configure URL and URL provider settings.

Use application clients

Starting the Application Client Resource Configuration Tool and opening an EAR file