A JAR (Java ARchive) is a zipped file that contains a set of Java classes. It is used to store compiled Java classes and associated metadata that can constitute a program. A JAR acts like a callable program library for Java code elements (so that a single compilation link provides access to multiple elements, rather than requiring bindings for each element individually). To learn more about JARs, see http://java.sun.com/docs/books/tutorial/deployment/jar/
JAR resources in BEA AquaLogic Service Bus are used in:
JAVA Callout action
EJB-based business services
In Tuxedo-based proxy and business services.
To learn more about Java Callout, see Java Callout.
The following table lists the JAR pages you can access from the Resource Browser and Project Explorer modules. The tasks and help topics associated with each are also provided.
The Summary of JARs page allows you to view a list of JAR (Java ARchive) files. A JAR is a special Java container file that acts like a callable program library for Java code elements. To learn more, see Overview of JARs.
To List and Locate JARs
From the left navigation pane, select JARs from under Resource Browser. The Summary of JARs page is displayed, which displays the following information for each JAR. For a more detailed description of the properties, see Viewing and Changing a JAR.
Table 8-2 JAR Details
Property
Description
JAR Name
The unique name assigned to the JAR. The name is a link to the JAR Details page. To learn more, see Viewing and Changing a JAR.
Path
The path is the project name and the name of the folder in which the JAR resides. It is a link to the project or folder that contains this resource. To learn more, see Viewing Project Details or Viewing Folder Details.
No. of Classes
The number of classes the JAR contains.
Size
The size of the JAR in bytes.
Options
Click the Delete icon to delete a specific JAR. To learn more, see Deleting a JAR.
To locate a specific JAR, do one of the following:
Search for a JAR using name and path filters. In the Name and Path fields, enter the name and path of the search target, then click Search. The path is the project name and the name of the folder in which the JAR resides. The JARs matching the search criteria are displayed.
Note:
This search supports wildcards. For example, you can enter “j*” in the Name field to get a list of JARs that start with “j”.
Sort the list. Click on an underlined column name. Ascending and descending arrows indicate the sort order. Click the column name to change the sort order.
Scroll through the pages. Use the page controls above or below the table. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.
The Create a New JAR Resourcepage allows you to add a new JAR (Java ARchive) file. A JAR is a special Java container file that acts like a callable program library for Java code elements. To learn more, see Overview of JARs.
To Add a New JAR
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session. To learn more, see Using the Change Center.
From the left navigation pane, select Project Explorer. The Project View page is displayed.
Select the project to which you want to add the JAR. You can add a JAR directly to the project, or you can add it to a selected folder that resides in the project.
Note:
Click the name of a folder to select it. The Folder View page is displayed.
From the Project View or Folder View page, in the Create Resource field, select JAR from under Transformation. The Create a New JAR Resource page is displayed.
In the Resource Name field, enter a unique name for this JAR. This is a required field.
In the Resource Description field, enter a description for the JAR.
In the JAR Source File field, do one of the following:
Enter the path to the location of the JAR.
Click Browseto locate and import an existing JAR.
Note:
This is a required field.
Click Save. The JAR resource is created.
The Project View or Folder View page is displayed. The new JAR is included in the list of resources. If the JAR loads without problems, the contents of the JAR will be available for viewing. To learn how to view JAR details, see Viewing and Changing a JAR.
The new JAR resource is saved in the current session.
When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to discard the changes you have made so far in the current session.
The View JAR Detailspage allows you to update a JAR (Java ARchive) file. Updating a JAR essentially involves pointing the resource to a new version of the JAR, as you cannot really edit a JAR usingAquaLogic Service Bus. A JAR is a special Java container file that contains Java classes and their dependencies. To learn more, see Overview of JARs.
Click the JAR name. The View JAR Details page displays the following information.
Table 8-3 JAR Configuration Details
Property
Description
Resource Name
The name assigned to this JAR.
Last Modified By
The name of the user who imported this JAR into the configuration.
Last Modified On
The date and time on which the user imported this JAR into the configuration.
References
A JAR will not have references.
Referenced by
The number of objects that reference this JAR. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.
Description
A description of this JAR, if one exists.
JAR Configuration
The list of classes and interfaces in this JAR.
Click (+) beside the name of a Java class to display a list of methods included in the class.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session, or click Edit to enter an existing session to make changes to the current configuration. To learn more, see Using the Change Center.
To make a change to the fields, click Edit. The only field you can edit is Description. You cannot really edit a JAR in AquaLogic Service Bus. To update the JAR, you must select a new JAR to use. To learn how, see Adding a JAR.
Do one of the following:
To update the JAR, click Save. The JAR is updated in the current session.
OR
To disregard changes, click Cancel.
The Summary of JARs page is displayed.
When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to discard the changes you have made so far in the current session.
WARNING:
If you change the JAR used by an EJB Business Service (point the JAR resource to a new version of the JAR), you need to redeploy the EJB. You will then have to edit any EJB service that uses this JAR, and reselect the JAR resource, save, and activate. That will repackage the EJB business service to use the new JAR.
WARNING:
Java Callout and Tuxedo-based services, however, will automatically pick up the new JAR.
The Summary of JARs page allows you to delete JAR (Java ARchive) files. A JAR is a zipped container file that stores compiled Java classes and associated metadata.
You cannot delete a resource if it is referenced by other resources in AquaLogic Service Bus. Instead of the Delete icon, a Delete icon with a red X is displayed for these resources.
To Delete a JAR
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select JARs from under Resource Browser. The Summary of JARs page is displayed.
In the Options field of the JAR you want to delete, click the Delete icon.
The JAR is removed from the list.
Note:
You can undo the deletion of this resource. To learn more, see Undoing a Task.
The JAR resource is deleted in the current session.
When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to discard the changes you have made so far in the current session.