* Copyright (c) 2020-2021 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See * for project information https://simulation.tudelft.nl. The DSOL * project is distributed under a three-clause BSD-style license, which can be found at * * https://simulation.tudelft.nl/dsol/3.0/license.html. *
* @author Alexander Verbraeck */ public class RemoteEventContext extends RemoteContext implements RemoteEventContextInterface { /** */ private static final long serialVersionUID = 20200208L; /** The event producer to which context events will be delegated for handling. */ private final ContextEventProducerImpl contextEventProducerImpl; /** * Constructs a new RemoteContext. Register the new context in the RMI registry. When the RMI registry does not exist yet, * it will be created, but only on the local host. Remote creation of a registry on another computer is not possible. * Any attempt to do so will cause an AccessException to be fired. * @param host String; the host where the RMI registry resides or will be created. Creation is only possible on localhost. * @param port int; the port where the RMI registry can be found or will be created * @param bindingKey the key under which this context will be bound in the RMI registry * @param embeddedContext ContextInterface; the underlying context * @param eventProducerBindingKey String; the key under which the event producer will be bound * @throws RemoteException when there is a problem with the RMI registry * @throws AlreadyBoundException when there is already another object bound to the bindingKey * @throws NullPointerException when host, path, or bindingKey is null * @throws IllegalArgumentException when port < 0 or port > 65535 * @throws AccessException when there is an attempt to create a registry on a remote host */ public RemoteEventContext(final String host, final int port, final String bindingKey, final ContextInterface embeddedContext, final String eventProducerBindingKey) throws RemoteException, AlreadyBoundException { super(host, port, bindingKey, embeddedContext, eventProducerBindingKey); this.contextEventProducerImpl = new ContextEventProducerImpl(this); } /** * Constructs a new RemoteContext. Register the new context in the RMI registry. When the host has not been specified in the * URL, 127.0.0.1 will be used. When the port has not been specified in the URL, the default RMI port 1099 will be used. * When the RMI registry does not exist yet, it will be created, but only on the local host. Remote creation of a * registry on another computer is not possible. Any attempt to do so will cause an AccessException to be fired. * @param registryURL URL; the URL of the registry, e.g., "http://localhost:1099" or "http://130.161.185.14:28452" * @param embeddedContext ContextInterface; the underlying context * @param eventProducerBindingKey String; the key under which the event producer will be bound * @throws RemoteException when there is a problem with the RMI registry * @throws AlreadyBoundException when there is already another object bound to the bindingKey * @throws NullPointerException when registryURL, bindingKey, or embeddedContext is null * @throws AccessException when there is an attempt to create a registry on a remote host */ public RemoteEventContext(final URL registryURL, final ContextInterface embeddedContext, final String eventProducerBindingKey) throws RemoteException, AlreadyBoundException { super(registryURL, embeddedContext, eventProducerBindingKey); this.contextEventProducerImpl = new ContextEventProducerImpl(this); } /** {@inheritDoc} */ @Override public boolean addListener(final EventListenerInterface listener, final String absolutePath, final ContextScope contextScope) throws RemoteException, NameNotFoundException, InvalidNameException, NotContextException, NamingException, NullPointerException { return this.contextEventProducerImpl.addListener(listener, absolutePath, contextScope); } /** {@inheritDoc} */ @Override public boolean addListener(final EventListenerInterface listener, final String absolutePath, final ContextScope contextScope, final ReferenceType referenceType) throws RemoteException, NameNotFoundException, InvalidNameException, NotContextException, NamingException, NullPointerException { return this.contextEventProducerImpl.addListener(listener, absolutePath, contextScope, referenceType); } /** {@inheritDoc} */ @Override public boolean addListener(final EventListenerInterface listener, final String absolutePath, final ContextScope contextScope, final int position) throws RemoteException, NameNotFoundException, InvalidNameException, NotContextException, NamingException, NullPointerException { return this.contextEventProducerImpl.addListener(listener, absolutePath, contextScope, position); } /** {@inheritDoc} */ @Override public boolean addListener(final EventListenerInterface listener, final String absolutePath, final ContextScope contextScope, final int position, final ReferenceType referenceType) throws RemoteException, NameNotFoundException, InvalidNameException, NotContextException, NamingException, NullPointerException { return this.contextEventProducerImpl.addListener(listener, absolutePath, contextScope, position, referenceType); } /** {@inheritDoc} */ @Override public boolean removeListener(final EventListenerInterface listener, final String absolutePath, final ContextScope contextScope) throws RemoteException, InvalidNameException, NullPointerException { return this.contextEventProducerImpl.removeListener(listener, absolutePath, contextScope); } }