changelog

详细的算法

MAJOR CHANGES in JADE 3.6 (05 May 2008)
==========================================================================
GENERAL IMPROVEMENTS:
- Added support to specify the jar file where to load agent code at agent startup
- SubscriptionResponder: Modified according to comments by Chris Audley and Henrique Lopes Cardoso
- Extended TopicManagementService to deal with registrations to topic templates (e.g. foo.bar.*)
- Added responder class for Iterated-Contract-Net protocol using the Single-Session approach
- Added SSResponderDispatcher class to manage protocol initiation messages and dispatch them to SSResponder behaviours
- Added support for different implementations of the Agent MessageQueue. By Arend Freije [[e-mail]] 
- Added method setO2AManager() in Agent class to associate a single behaviour to the O2A communication mechanism. 
- Modified automatic main detection mechanism to print a warning and go on when the initialization fails (on the Main Container) and it was not explicitly tured on
- Modified automatic main detection mechanism to require users to specify '*' as platform name (on peripheral containers) when they want to connect to whatever platform 
- Added support to deregister transitions in FSMBehaviour 
- Modified MainReplicationService to issue NEW_NODE and NEW_SLICE VCommands when a Main Container replica enters the ring
- Added method dump() to BaseService to support runtime service inspection by means of the ContainerMonitorAgent (misc Add-On)
- Added method getLocalServices() in ServiceManager interface
- Modified KeyStoreKeyManager to support selection of the keystore type (default still JKS, but other possible, eg. PKCS12). By Arend Freije [[e-mail]] 
- Added method hasDefaultTransition() in FSMBehaviour
- Sustituted AgentContainer#livesHere() with isLocalAgent()
- Modified SLCodec to support Java primitive types (long, int, float double) preservation in un-typed attributes
 
BUG-FIXES:
- Fixed bug in SSAchieveREResponder related to the receiption of successive messages when a performative different than REQUEST was used (Fix by Chris Audley)
- Fixed bug in WakerBehaviour reset() method
- Included HTTPS-classes in http.jar (also fixed build.xml). By Arend Freije  
- Fixed bug in inter-platform communication: if the receiver did not exist in the remote platform no FAILURE message was returned to the sender  
- Fixed problem when the PersistentDeliveryService stores a message for a foreign receiver (this information was lost by the PersistentDeliveryProxy). 

LEAP:
  - FrontEndCOntainer: Modified method exit() to avoid deadlock when activated from MicroRuntime.stop()
  - BEManagementService: Added sanity check to avoid using a cancelled SelectionKey (problem indicated by Reza Mohseny)
  - Added support for Object-2-Agent communication on split containers
  - Fixed bug in FEService.


ADD-ONS:
- JADE-ANDROID Add-on
  - New Add-on allowing deployment of JADE-based applications on Google Android platform

- Misc Add-on
  - Added support for leader election within an open group (members can appear and disappear at any time) of agents 
  - Added support for DUMP-SERVICE action in ContainerMonitorAgent

- WSIG Add-on
  - Support for optional/unordered parameters in Web Service invocations
  - Improved AgentAction object construction from Web Service parameters
  - Improved exception handling and error messages
  - Added support for further WSDL customization by means of the OntologyName and SuppressOperation annotations.
  - Modification to use XML validation schemes at non-standard addresses.
  - Fixed problem related to usage of Basic Ontology types (such as AID) as Web Service operation parameters (bug indicated by Jason Woodrich) 
  - Some fixes to make things fully compliant to standards.
  - Updated Guide and examples.
  
- XMLCodec Add-on
  - Modified to preserve Java primitive types (long, int, float double) in un-typed attributes
  - Modified to properly handle SET and SEQUENCE aggregates

DOCUMENTATION:
- Updated guides

POSSIBLE BACKWARD INCOMPATIBILITIES:
API: NONE

EXPECTED BEHAVIOUR:
- The detect-main option specified on peripheral containers requires the specification of the name of the platform 
to connect to by means of the -name option. In order to connect to whatever platform it is possible to specify -name *





MAJOR CHANGES in JADE 3.5 (25 June 2007)
==========================================================================
GENERAL IMPROVEMENTS:
DF	
- Modified DF to automatically remove subscriptions of dead agents when the autocleanup option is specified
- Modified DF to support a pool of thread serving registration, deregistration and search requests when using DB-based KnowledgeBase (option jade_domain_df_poolsize)
- Modified DF to support turning off content validation mode (option jade_domain_df_disablevalidation) 
- Optimized DF search when using DB-based KnowledgeBase
- Modified DF to cache subscription relevant information. This speeds up performances when detecting subscribed agents to be notified about registration updates

Content language and ontologies
- Created CFReflectiveIntrospector to support usage of java.util classes in ontological classes
- Added methods to get predicate, concept and action names from an ontology
- Committed automatically generated SL and ACL parser classes
- Added method to define action-result type in AgentActionSchema

Kernel
- Added automatic Main-Container detection via multicast (option detect-main)
- Modified MainReplicationService to support detailed REMOVED_CONTAINER and DEAD_AGENT events notification instead of just RESET meta-event
- Modified FullResourceManager to avoid annoying stack traces at platform shutdown
- Modified MainContainerImpl to start the AMS and DF threads in the SystemAgent Thread Group
- Added dump-options option to print out configuration options at container startup
- Modified ContainerID class to include main/non-main indication
- added package scoped method getThread in the class Agent
- added package scoped methods getSize in jade.core.messaging.OutBox
- added package scoped methods getThreadPoolStatus and getThreadPool in jade.core.messaging.MessageManager
- added public methods getQueueSize and getThreadPool in jade.core.messaging.MessagingService
- Modified CodeLocator to use Base64 encoder by Apache commons-codec instead of sun.misc.BASE64Encoder as suggested by Jordi Cucurull Juan
- Modified CodeLocator to deal with ClassLoader instead of jar files by Jordi Cucurull Juan
- Modified AgentMobilityService to work with Java6 (load incoming agent classes by calling Class.forName(<class-name>, true, cl) instead of cl.loadClass(<class-name>)

MTP
- Integrated patch by Arend Freije (Minihouse) to avoid http MTP block all delivery processes when one takes a lot of time.

Tools
- Modified AgentTree class to show agents within a container in alphabetical order
- Improved management of colors in the Sniffer
 
BUG-FIXES:
- Integraed fix by Geoffrey De Smet to properly deal with loggers that are not JADE loggers. 
- Fixed problem with Mobility and Java6 due to Java6 backward incompatibility https://glassfish.dev.java.net/issues/show_bug.cgi?id=714
- Added sanity check in MainContainerImpl.containerAgents() as indicated by Carlo Corda.
- Added sanity check on MainContainerImpl to deal with terminating agents while a query-agents-on-location action is served. 

LEAP:
- Added support for ServiceHelper retrieval and usage in split container execution mode
- Added support for automatically changing the local port of the Main Container in case the specified port (or the default one) is busy (jade_imtp_leap_LEAPIMTPManager_changeportifbusy option). 
- Added detach/attach functionality to the split execution mode   
- Modified LEAP ConnectionPool to move connection creation outside a synchronized block. This avoids blocking all threads trying to interact with remote containers when one is taking a lot of time opening a network connection (e.g. due to TCP timeouts)
- Fixed bug in single-connection FE-BE connector class (jade.imtp.leap.JICP.FrontEndDispatcher) related to duplicated session-ID
- Fixed bug when restarting JADE-LEAP inside Tomcat (or another application that uses different classloaders each time) "No skeleton for object-id" reported first by Jaran Nilsen


ADD-ONS:
- Persistence Add-on
  - Some fix to properly support MySql DB (by Vincenzo Gioviale)

- Misc Add-on
  - Added dump of threads owned by an Agent (its Thread and its threaded behaviours)
  - Added dump of all threads in a container   
  - Added dump of deliverer threads

- JADE-SHARP Add-on
  - New add-on allowing Microsoft .NET clients (fully compatible with .NET Compact Framework) to connect to a JADE-based multi agent system and to exchange ACLMessages with remote agents

- Security Add-on
  - Fixed bug (OutOfMemoryError) in encryption mechanism when encoding block-size is 0
  - Fixed bug (ArrayIndexOutOfBoundException) in PermissionFIlter while checking an incoming KILL_CONTAINER command
  - Reorganized messaging example to allow showing that a message is encrypted using the Sniffer


DOCUMENTATION:
- New tutorial on JADE-JESS integration by Henrique Lopes Cardoso (University of Porto)
- Updated tutorial on Content Languages and Ontologies with information about the new CFReflectiveIntrospector
- New examples about the topic-based message delivery mechanism
- Updated the Programmer's Guide with information about the topic-based message delivery mechanism
- Updated the Administrator's Guide with information about the automatic main detection mechanism
- Adjusted javadoc information for kernel level services classes

POSSIBLE BACKWARD INCOMPATIBILITIES:
API: NONE

EXPECTED BEHAVIOUR:
- When using Main Container replication, tool-agents now receive detailed REMOVED_CONTAINER and DEAD_AGENT events instead of just the RESET meta-event. 
A fully backward-compatible behaviour can be obtained by setting to true the jade_core_replication_MainReplicationService_snapshotonfailure configuration option




MAJOR CHANGES in JADE 3.4.1 (15th November 2006)  
==========================================================================
GENERAL IMPROVEMENTS:	
- Modified HTTP MTP to properly select the XML parser (by Kre拧imir Jurasovic - University of Zagreb).
- Substituted getHostName() with getCanonicalHostName() in HTTP MTP to resolve domain problems.
- Added support for low-level container introspection by means of the ContainerMonitorAgent (jade_core_AgentContainerImpl_enablemonitor parameter).
- Added method getParam(int index) to JADE commands (jade.core.Command class).
- Modified message tracing mechanism to take the ACLMessage.TRACE user define property into account.
- Improved agent cloning error management.
- Added generation of ShutdownPlatformRequested AMS event (Introspection Ontology)
- Modified ThreadedBehaviourFactory to support Threaded-behaviour suspension.
- Modified default behaviour of jade.wrapper.gatreway.GatewayAgent to automatically call releaseCommand() when a Behaviour is passed in the execute() method of the JadeGateway class.
- Refactored Notification Service to i) use sinks for owned commands, and ii) dispatch ContainerEvents.
- Modified Agent.powerUp() method to avoid starting the agent thread two times. 

BUG-FIXES:
- Fixed bug in SSResponder when initiator and responder are the same agent
- Fixed bug in ParallelBehaviour related to remotion of already terminated children (indicated by Juan A. Su谩rez-Romero - University of A Coru帽a)
- Fixed deadlock problem in OutgoingEncodingFilter due to useless synchronized block on AgentContainerImpl.
- Fixed bug notified by Maciej Gawinecki so that when trying to kill multiple agents at the same time from the RMA only the first one was actually killed (jade.tools.ToolAgent class).
- Fixed bug in jade.BootGUI (notified by Maciej Gawinecki, fix by Walter, Patrick A).
- Fixed problems in jade.proto.SSIteratedAchieveREResponder.
- Fixed bug in conversation ID generation (in some cases it was not unique) in the FIPAService.doFipaRequestClient() method.
- Fixed problem about jar file removal in CodeLocator (by Jordi Cucurull Juan).
- Fixed problem with the -main configuration option in BootProfileImpl.
- Fixed problem in the visualization of pending/sent messages in the Introspector agent.
- Fixed problem in Introspector agent related to behaviour status updating.
- Fixed bug in ToolNotifier: an inner behaviour did not block waiting for incoming messages --> in certain cases a terrible waste of CPU could be experienced.
 
 
LEAP:
- Modified CommandDispatcher skeleton ID generation mechanism to avoid problems when a container terminates and then restarts with the same name
- Modified to support socket timeout configuration (jade_imtp_leap_JICP_JICPPeer_connectiontimeout parameter)
- Fixed problem with reconnection after DROP_DOWN in single-connection BE-FE dispatcher class (jade.imtp.leap.nio.BackEndDispatcher)


ADD-ONS:
- Semantics Framework