org.ccsds.moims.mo.mal.helpertools.connections.ConnectionProvider Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of api-area001-v003-mal Show documentation
Show all versions of api-area001-v003-mal Show documentation
An implementation of the Java API for the CCSDS MAL
The newest version!
/* ----------------------------------------------------------------------------
* Copyright (C) 2021 European Space Agency
* European Space Operations Centre
* Darmstadt
* Germany
* ----------------------------------------------------------------------------
* System : CCSDS MO MAL Java API
* ----------------------------------------------------------------------------
* Licensed under the European Space Agency Public License, Version 2.0
* You may not use this file except in compliance with the License.
*
* Except as expressly set forth in this License, the Software is provided to
* You on an "as is" basis and without warranties of any kind, including without
* limitation merchantability, fitness for a particular purpose, absence of
* defects or errors, accuracy or non-infringement of intellectual property rights.
*
* See the License for the specific language governing permissions and
* limitations under the License.
* ----------------------------------------------------------------------------
*/
package org.ccsds.moims.mo.mal.helpertools.connections;
import org.ccsds.moims.mo.mal.helpertools.helpers.HelperConnections;
import org.ccsds.moims.mo.mal.helpertools.helpers.HelperMisc;
import java.io.BufferedWriter;
import java.io.FileWriter;
import java.io.IOException;
import java.util.Properties;
import java.util.logging.Level;
import java.util.logging.Logger;
import org.ccsds.moims.mo.mal.MALContext;
import org.ccsds.moims.mo.mal.MALContextFactory;
import org.ccsds.moims.mo.mal.MALException;
import org.ccsds.moims.mo.mal.ServiceInfo;
import org.ccsds.moims.mo.mal.helpertools.helpers.HelperDomain;
import org.ccsds.moims.mo.mal.provider.MALInteractionHandler;
import org.ccsds.moims.mo.mal.provider.MALProvider;
import org.ccsds.moims.mo.mal.provider.MALProviderManager;
import org.ccsds.moims.mo.mal.structures.Blob;
import org.ccsds.moims.mo.mal.structures.IntegerList;
import org.ccsds.moims.mo.mal.structures.QoSLevel;
import org.ccsds.moims.mo.mal.structures.UInteger;
import org.ccsds.moims.mo.mal.structures.URI;
/**
* Holds the connection details of a service provider.
*/
public class ConnectionProvider {
private MALContextFactory malFactory;
private MALContext mal;
private MALProviderManager providerMgr;
private MALProvider primaryMALServiceProvider = null;
private MALProvider secondaryMALServiceProvider = null;
private final SingleConnectionDetails primaryConnectionDetails = new SingleConnectionDetails();
private SingleConnectionDetails secondaryConnectionDetails = null;
private static final ServicesConnectionDetails globalProvidersDetailsPrimary = new ServicesConnectionDetails();
private static final ServicesConnectionDetails globalProvidersDetailsSecondary = new ServicesConnectionDetails();
/**
* Getter for the primaryConnectionDetails object.
*
* @return The primary connection details.
*/
public SingleConnectionDetails getConnectionDetails() {
return primaryConnectionDetails;
}
/**
* Returns the primary connection details.
*
* @return The primary connection details.
*/
public SingleConnectionDetails getPrimaryConnectionDetails() {
return primaryConnectionDetails;
}
/**
* Returns the secondary connection details.
*
* @return The secondary connection details.
*/
public SingleConnectionDetails getSecondaryConnectionDetails() {
return secondaryConnectionDetails;
}
/**
* Get primary connection interface details of all providers in the
* application.
*
* @return Primary connection details of all providers in the application.
*/
public static ServicesConnectionDetails getGlobalProvidersDetailsPrimary() {
return globalProvidersDetailsPrimary;
}
/**
* Get secondary connection interface details of all providers in the
* application.
*
* @return Secondary connection details of all providers in the application.
*/
public static ServicesConnectionDetails getGlobalProvidersDetailsSecondary() {
return globalProvidersDetailsSecondary;
}
/**
* Returns the connection details of the inter-process communication (ipc).
* This is usually the "secondary" connection but if we only have a
* "primary" connection then this is the one to be returned.
*
* @return The ipc connection details
*/
public SingleConnectionDetails getIPCConnectionDetails() {
return (secondaryConnectionDetails != null) ? secondaryConnectionDetails : primaryConnectionDetails;
}
/**
* Closes any existing service providers and recreates them. Used to
* initialize services.
*
* @param serviceName Name of the service
* @param malService MAL service
* @param handler The handler of the interaction
* @return The MAL provider
* @throws MALException On error.
*/
public MALProvider startService(String serviceName, ServiceInfo malService,
MALInteractionHandler handler) throws MALException {
return startService(serviceName, malService, true, handler);
}
/**
* Closes any existing service providers and recreates them. Used to
* initialize services.
*
* @param malService MAL service
* @param isPublisher Boolean flag to define if the service has PUB-SUB
* @param handler The handler of the interaction
* @return The MAL provider
* @throws MALException On error.
*/
public MALProvider startService(ServiceInfo malService,
boolean isPublisher, MALInteractionHandler handler) throws MALException {
return startService(malService.getName().getValue(), malService, isPublisher, handler);
}
/**
* Closes any existing service providers and recreates them. Used to
* initialize services.
*
* @param serviceName Name of the service
* @param malService MAL service
* @param isPublisher Boolean flag to define if the service has PUB-SUB
* @param handler The handler of the interaction
* @return The MAL provider
* @throws MALException On error.
*/
public MALProvider startService(String serviceName, ServiceInfo malService,
boolean isPublisher, MALInteractionHandler handler) throws MALException {
try {
malFactory = MALContextFactory.newFactory();
} catch (MALException ex) {
Logger.getLogger(ConnectionProvider.class.getName()).log(Level.SEVERE,
"Check if the MAL implementation is included in your project!! "
+ "This error usually happens when the MAL layer is missing.", ex);
}
mal = malFactory.createMALContext(System.getProperties());
providerMgr = mal.createProviderManager();
URI sharedBrokerURI = null;
if ((null != System.getProperty(HelperMisc.PROPERTY_SHARED_BROKER_URI))) {
sharedBrokerURI = new URI(System.getProperty(HelperMisc.PROPERTY_SHARED_BROKER_URI));
}
final String moAppName = System.getProperty(HelperMisc.PROP_MO_APP_NAME);
final String uriName = (moAppName != null) ? moAppName + "-" + serviceName : serviceName; // Create the uri string name
Properties props = new Properties();
props.putAll(System.getProperties());
MALProvider serviceProvider = providerMgr.createProvider(uriName,
null,
malService,
new Blob("".getBytes()),
handler,
new QoSLevel[]{
QoSLevel.ASSURED
},
new UInteger(1),
props,
isPublisher,
sharedBrokerURI,
null);
IntegerList serviceKey = new IntegerList();
serviceKey.add((int) malService.getAreaNumber().getValue()); // Area
serviceKey.add(malService.getServiceNumber().getValue()); // Service
serviceKey.add((int) malService.getServiceVersion().getValue()); // Version
primaryConnectionDetails.setProviderURI(serviceProvider.getURI());
primaryConnectionDetails.setBrokerURI(serviceProvider.getBrokerURI());
primaryConnectionDetails.setDomain(ConfigurationProviderSingleton.getDomain());
primaryConnectionDetails.setServiceKey(serviceKey);
Logger.getLogger(ConnectionProvider.class.getName()).log(Level.FINE,
"\n" + serviceName + " Service URI : {0}"
+ "\n" + serviceName + " Service broker URI : {1}"
+ "\n" + serviceName + " Service domain : {2}"
+ "\n" + serviceName + " Service key : {3}",
new Object[]{
primaryConnectionDetails.getProviderURI(),
primaryConnectionDetails.getBrokerURI(),
primaryConnectionDetails.getDomain(),
serviceKey
});
this.writeURIsOnFile(primaryConnectionDetails,
serviceName,
HelperMisc.PROVIDER_URIS_PROPERTIES_FILENAME);
globalProvidersDetailsPrimary.add(serviceName, primaryConnectionDetails);
primaryMALServiceProvider = serviceProvider;
final String secondaryProtocol = System.getProperty(HelperMisc.SECONDARY_PROTOCOL);
// Check if the secondary Transport is enabled
if (secondaryProtocol != null) {
secondaryConnectionDetails = new SingleConnectionDetails();
MALProvider serviceProvider2 = providerMgr.createProvider(uriName,
secondaryProtocol,
malService,
new Blob("".getBytes()),
handler,
new QoSLevel[]{
QoSLevel.ASSURED
},
new UInteger(1),
props,
isPublisher,
sharedBrokerURI,
null);
secondaryConnectionDetails.setProviderURI(serviceProvider2.getURI());
secondaryConnectionDetails.setBrokerURI(serviceProvider2.getBrokerURI());
secondaryConnectionDetails.setDomain(ConfigurationProviderSingleton.getDomain());
secondaryConnectionDetails.setServiceKey(serviceKey);
Logger.getLogger(ConnectionProvider.class.getName()).log(Level.FINE,
"\n" + serviceName + " Service URI : {0}"
+ "\n" + serviceName + " Service broker URI : {1}"
+ "\n" + serviceName + " Service domain : {2}"
+ "\n" + serviceName + " Service key : {3}",
new Object[]{
secondaryConnectionDetails.getProviderURI(),
secondaryConnectionDetails.getBrokerURI(),
secondaryConnectionDetails.getDomain(),
serviceKey
});
this.writeURIsOnFile(secondaryConnectionDetails,
serviceName,
HelperMisc.PROVIDER_URIS_SECONDARY_PROPERTIES_FILENAME);
globalProvidersDetailsSecondary.add(serviceName, secondaryConnectionDetails);
secondaryMALServiceProvider = serviceProvider2;
}
return serviceProvider;
}
/**
* Closes all running threads and releases the MAL resources. The method has
* been deprecated and closeAll should be used instead.
*/
@Deprecated
public void close() {
try {
if (null != providerMgr) {
providerMgr.close();
}
if (null != mal) {
mal.close();
}
} catch (MALException ex) {
Logger.getLogger(ConnectionProvider.class.getName()).log(Level.WARNING,
"Exception during close down of the provider {0}", ex);
}
}
/**
* Closes all running threads and releases the MAL resources.
*/
public void closeAll() {
try {
if (null != primaryMALServiceProvider) {
primaryMALServiceProvider.getClass();
primaryMALServiceProvider.close();
}
if (null != secondaryMALServiceProvider) {
secondaryMALServiceProvider.close();
}
} catch (MALException ex) {
Logger.getLogger(ConnectionProvider.class.getName()).log(Level.WARNING,
"Exception during close down of the provider {0}", ex);
}
try {
if (null != providerMgr) {
providerMgr.close();
}
if (null != mal) {
mal.close();
}
} catch (MALException ex) {
Logger.getLogger(ConnectionProvider.class.getName()).log(Level.WARNING,
"Exception during close down of the provider {0}", ex);
}
}
/**
* Clears the URI links file of the provider
*/
public static void resetURILinksFile() {
BufferedWriter wrt = null;
try {
wrt = new BufferedWriter(new FileWriter(HelperMisc.PROVIDER_URIS_PROPERTIES_FILENAME, false));
} catch (IOException ex) {
Logger.getLogger(ConnectionProvider.class.getName()).log(Level.WARNING,
"Unable to reset URI information from properties file {0}", ex);
} finally {
if (wrt != null) {
try {
wrt.close();
} catch (IOException ex) {
}
}
}
if (System.getProperty(HelperMisc.SECONDARY_PROTOCOL) != null) {
BufferedWriter wrt2 = null;
try {
wrt2 = new BufferedWriter(new FileWriter(HelperMisc.PROVIDER_URIS_SECONDARY_PROPERTIES_FILENAME, false));
} catch (IOException ex) {
Logger.getLogger(ConnectionProvider.class.getName()).log(Level.WARNING,
"Unable to reset URI information from properties file {0}", ex);
} finally {
if (wrt2 != null) {
try {
wrt2.close();
} catch (IOException ex) {
}
}
}
}
}
/**
* Writes the URIs on a text file
*/
private void writeURIsOnFile(SingleConnectionDetails connectionDetails, String serviceName, String filename) {
BufferedWriter wrt = null;
try {
wrt = new BufferedWriter(new FileWriter(filename, true));
wrt.append(serviceName + HelperConnections.SUFFIX_URI + "=" + connectionDetails.getProviderURI());
wrt.newLine();
wrt.append(serviceName + HelperConnections.SUFFIX_BROKER + "=" + connectionDetails.getBrokerURI());
wrt.newLine();
wrt.append(serviceName + HelperConnections.SUFFIX_DOMAIN + "=" + HelperDomain.domain2domainId(connectionDetails.getDomain()));
wrt.newLine();
wrt.append(serviceName + HelperConnections.SUFFIX_SERVICE_KEY + "=" + connectionDetails.getServiceKey());
wrt.newLine();
} catch (IOException ex) {
Logger.getLogger(ConnectionProvider.class.getName()).log(Level.WARNING,
"Unable to write URI information to properties file {0}", ex);
} finally {
if (wrt != null) {
try {
wrt.close();
} catch (IOException ex) {
}
}
}
}
}