fr.dyade.aaa.agent.AgentFactory Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of a3-rt Show documentation
Builds the Joram a3 rt project.
There is a newer version: 5.22.0-EFLUID
/*
 * Copyright (C) 2001 - 2021 ScalAgent Distributed Technologies
 * Copyright (C) 1996 - 2000 BULL
 * Copyright (C) 1996 - 2000 INRIA
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or any later version.
 * 
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
 * USA.
 */
package fr.dyade.aaa.agent;

import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.ObjectInputStream;

import org.objectweb.util.monolog.api.BasicLevel;

/**
 * Agent used to allow remote agent creation. Every agent
 * server hosts a factory agent, they all use a predefined stamp identifier
 * AgentId.factoryId. The factory must be able to create all
 * types of objects, actually it is supposed that the corresponding classes
 * can be reached.
 * The agent creation process involves the following steps
 * 

 * locally creating the Agent object in memory ;
 * 
serializing the agent state, building an AgentCreateRequest
 * 	notification with the resulting string, sending it to the target
 * 	Factory agent ;
 * 
the factory agent building the object in memory from the serialized
 * 	image, and saving it into operational storage ;
 * 
the factory agent calling the initialize method.
 * 
 * The AgentDeleteRequest class of notification follows a similar process
 * to remotely delete agents.
 */
final class AgentFactory extends Agent {
  /** define serialVersionUID for interoperability */
  private static final long serialVersionUID = 1L;

  /**
   * Allocates a new AgentFactory agent.
   * An AgentFactory agent must be created on every agent
   * server the first time it runs.
   * 
   * @param factoryId unique identifier for factory agent.
   */
  AgentFactory(AgentId factoryId) {
    super("AgentFactory#" + AgentServer.getServerId(), true, factoryId);
  }

  /**
   * Returns log topic for factory agent.
   */
  protected String getLogTopic() {
    return AgentFactory.class.getName() + ".#" + AgentServer.getServerId();
  }

  /**
   * Gives this agent an opportunity to initialize after having been
   * deployed, and each time it is loaded into memory. Loads the list of
   * agents with a fixed field set to true.
   *
   * @param firstTime		true when first called by the factory
   *
   * @exception Exception
   *	unspecialized exception
   */
  protected void agentInitialize(boolean firstTime) throws Exception {
    super.agentInitialize(firstTime);
  }

  /**
   * Reacts to notifications ... .
   *
   * @param from	agent sending notification
   * @param not		notification to react to
   *
   * @exception Exception
   *	unspecialized exception
   */
  public void react(AgentId from, Notification not) throws Exception {
    if (not instanceof AgentCreateRequest) {
      AgentCreateRequest cnot = (AgentCreateRequest) not;
      try {
        // Restore the new agent state.
        ObjectInputStream ois = new ObjectInputStream(new ByteArrayInputStream(cnot.agentState, 0, cnot.agentState.length));
        Agent ag = (Agent) ois.readObject();
        try {
          ois.close();
        } catch (IOException exc) {}

        // Initializes and creates the agent
        // TODO: (ThreadEngine) Thread.currentThread() ...
        AgentServer.engine.createAgent(cnot.deploy, ag);

        if (logmon.isLoggable(BasicLevel.DEBUG))
          logmon.log(BasicLevel.DEBUG,
                     "AgentFactory" + id + ", create Agent" + ag.id + " [" + ag.name + "]");
        if (cnot.reply != null) {
          AgentCreateReply reply = new AgentCreateReply(ag.getId());
          reply.setContext(cnot.getContext());
          sendTo(cnot.reply, reply);          
        }
      } catch (Throwable error) {
        //  If there is an explicit reply request send it the
        // ExceptionNotification to the requester else to the
        // sender.
        cnot.agentState = null;
        logmon.log(BasicLevel.ERROR,
                   "AgentFactory" + id + ", can't create Agent" + cnot.deploy,
                   error);
        ExceptionNotification excNot = 
          new ExceptionNotification(getId(), cnot, new AgentException(error));
        excNot.setContext(cnot.getContext());
        if (cnot.reply != null) {
          sendTo(cnot.reply, excNot);
        } else {
          sendTo(from, excNot);
        }
      }
    } else if (not instanceof AgentDeleteRequest) {
      try {
        // TODO: (ThreadEngine) Thread.currentThread() ...
        AgentServer.engine.deleteAgent(from);
        if (((AgentDeleteRequest) not).reply != null)
          sendTo(((AgentDeleteRequest) not).reply,
                 new DeleteAck(from, ((AgentDeleteRequest) not).extraInformation));
      } catch (Exception exc) {
        if (((AgentDeleteRequest) not).reply != null)
          sendTo(((AgentDeleteRequest) not).reply, new DeleteAck(from, exc));
      }
    } else {
      try {
        super.react(from, not);
      } catch (Exception exc) {
        sendTo(from,
               new ExceptionNotification(getId(), not, exc));
      }
    }
  }
}