- The Java Server API provides tools primarily for creating and modifying connectors, workflows, and components on both the ingestion and querying sides of the architecture.
- The Java Client API provides tools for feeding documents and submitting queries from external Java applications.
- The Java Model API provides many supporting classes that are used in both the server and client libraries.
AIE Designer is a turnkey Eclipse-based development environment for extending AIE through the Java APIs. Projects created through Designer (or through the createproject command-line utility) include a complete set of Eclipse project files.
You can also configure the project to include Java API sample code demonstrating many of the features of the Server and Client APIs. This makes it easier to write custom client applications, transformers and services. The examples also include abstract test classes, a sample unit test for a transformer, and a sample integration test. You can run everything directly from Designer.
This page is primarily about setting up a project for AIE development in Designer.
View incoming links.
To set up AIE for customization/extension using the Java APIs, simply include the AIE Designer in the installation. (Designer requires an add-on installer as it is not included included in the default installer)
Creating the Project
In the examples that follow, AIE is installed in the C:\attivio directory, which is referred to as <install-dir>. The project is called plusjava (meaning "factbook plus java"), and uses C:\attivio-projects\plusjava as the project directory. This is referred to as the <project-dir> in the examples.
To create the example project using AIE Designer, follow these steps:
Be sure that AIE Agent is running on the computer where AIE is installed. It might be running as a service, or you can manually it.
Start AIE Designer. If you don't have a desktop icon for this purpose, you can start it manually.
If this is your first time using Designer it will ask you to designate a workspace (C:\workspace) then Click Use Designer to bypass the Welcome to Designer page.
Open the AIE Configuration menu, and select New AIE Project then in the New AIE Project dialog box, give the project a name. We used "plusjava". Click Next.
Add the necessary modules to the project. For this exercise we selected the Demo group and the factbook module then check the box labeled Include sample code in the project. Click Finish.
Testing the Software Installation
After generating a project, how do you know that everything has been set up correctly for Java API development?
The AIE project includes several example files, some of which can be run from Designer as JUnit tests. If the example file compiles and runs, then the environment has been set up correctly.
To verify that the environment is set up and functioning, run the demo integration test example.
Before running this test, be sure that the ATTIVIO_HOME environment variable is set to the AIE installation directory.
Note that AIE does not need to be running for this test. The test will start and stop its own AIE server.
- In the Designer Package Explorer view, access the test/com.acme directory.
- Right-click on SampleIntegrationTest.java. From the pop-up menu, select Run As > Junit Test.
This is a simple test that runs a single IngestDocument through the ingestion process. It displays several screenfuls of status messages. The following lines indicate a successful test.
Creating Custom Code