Difference between revisions of "BaSyx.Examples.Snippets.AASConnection.Java"

Revision as of 09:47, 18 August 2020

This code snippet illustrates the connection to an Asset Administration Shell (AAS) using the Java SDK with the ConnectedAssetAdministrationShellManager class. It illustrates the connection to an AAS with a known ID, as well as reading and updating of properties.

The BaSys setup for this code snippet is the following:

The BaSys setup consists of a Apache Tomcat server that runs BaSyx Servlets. It contains an asset administration shell provider that exports an example Asset Administration Shell (see here for example). The snippet code runs in context of an application. The application contains the example code and a precompiled BaSyx directory that is used for resolving AAS and sub model IDs to network addresses. The following application code accesses the AAS:

// Create manager using the directory stub an the HTTPConnectorProvider
// - Connect to VAB object by ID. The connection manager looks up this ID in
//   its directory
ConnectedAssetAdministrationShellManager manager = new ConnectedAssetAdministrationShellManager(registry,
		// We connect via HTTP
		new HTTPConnectorProvider());
 
	// Retrieve the AAS from the AAS server with SDK connector
	// - IAssetAdministrationShell is the interface for the local AAS proxy
	IAssetAdministrationShell shell = manager
		.retrieveAAS(new ModelUrn("aas-001"));
	// - Retrieve AAS values and compare to expected values
	Object propertyId = shell.getIdShort();
 
 
	// Check result
	assertTrue(propertyId.equals("aas-001"));

The code first creates a connected Asset Administration Shell manager that creates connections to Asset Administration Shells. It uses a ConnectionManager class to create the connection and to resolve AAS and sub model IDs:

// Create manager using the directory stub an the HTTPConnectorProvider
// - Connect to VAB object by ID. The connection manager looks up this ID in
//   its directory
ConnectedAssetAdministrationShellManager manager = new ConnectedAssetAdministrationShellManager(registry,
	// We connect via HTTP
	new HTTPConnectorProvider());

The following code connects to the AAS with ID "aas-001". It returns a IAssetAdministrationShell instance that provides a local proxy for the remote AAS.

// Retrieve the AAS from the AAS server with SDK connector
// - IAssetAdministrationShell is the interface for the local AAS proxy
IAssetAdministrationShell shell = manager
	.retrieveAAS(new ModelUrn("aas-001"));

The following code accesses the meta property idShort of the AAS and compares its value to the expected value "aas-001"

// - Retrieve AAS values and compare to expected values
Object propertyId = shell.getIdShort();
assertTrue(propertyId.equals("aas-001"));

The complete, executable code is available in the basyx.examples project in package <<<org.eclipse.basyx.examples.snippets.aas.deployment.http>>>.