Magentix2  2.1.1
jason.stdlib.ia_fipa_subscribe_Initiator Class Reference
Inheritance diagram for jason.stdlib.ia_fipa_subscribe_Initiator:
Collaboration diagram for jason.stdlib.ia_fipa_subscribe_Initiator:

List of all members.

Public Member Functions

int getMinArgs ()
int getMaxArgs ()
void checkArguments (Term[] args) throws JasonException
Object execute (TransitionSystem ts, Unifier un, Term[] args) throws Exception

Package Attributes

Jason_Fipa_Subscribe_Initiator fsi = null

Detailed Description

This class represents the internal action to be used when adding a conversation to a Jason agent under the Fipa Subscribe Protocol as initiator

Author:
Bexy Alfonso Espinosa

Definition at line 28 of file ia_fipa_subscribe_Initiator.java.


Member Function Documentation

void jason.stdlib.ia_fipa_subscribe_Initiator.checkArguments ( Term[]  args) throws JasonException

Definition at line 42 of file ia_fipa_subscribe_Initiator.java.

        {
                super.checkArguments(args);
                boolean result = false;

                if (  (((Term)args[args.length-1]).isAtom())||
                                (((Term)args[args.length-1]).isString())||
                                (((Term)args[args.length-1]).isLiteral())||
                                (((Term)args[args.length-1]).isNumeric())){result=true;}

                result = (result && (((Term)args[0]).isString()) );

                if ( protocolSteep.compareTo(Protocol_Template.START_STEP)==0)
                {
                        int cont = 0; 
                        for (Term t:args){
                                switch (cont){
                                case 1:result = ((result&&t.isAtom())||(result&&t.isString())); 
                                break;
                                case 2:result = (result&&t.isNumeric());
                                break;
                                case 3:result = (result&&t.isString());
                                break;
                                }
                                cont++;
                        }
                }


                if (protocolSteep.compareTo(Protocol_Template.SUBSCRIBE_STEP)==0)
                {
                        int cont = 0; 
                        for (Term t:args){
                                switch (cont){
                                case 1:result = (result&&t.isList());
                                break;
                                case 2:result = ((result&&t.isAtom())||(result&&t.isString())); 
                                break;
                                }
                                cont++;
                        }
                }
                
                if (!result)
                {
                        throw JasonException.createWrongArgument(this,"Parameters must be in correct format.");
                }

        }
Object jason.stdlib.ia_fipa_subscribe_Initiator.execute ( TransitionSystem  ts,
Unifier  un,
Term[]  args 
) throws Exception

Definition at line 94 of file ia_fipa_subscribe_Initiator.java.

                                                                                             {

                protocolSteep = getTermAsString(args[0]);

                checkArguments(args);
                
                agentConversationID = getTermAsString(args[args.length-1]);
                if (((Term)args[args.length-1]).isString()){
                        agentConversationID = "\""+agentConversationID+"\"";
                }
                
                agName  = ts.getUserAgArch().getAgName();

                ConvJasonAgent myag = ((ConvMagentixAgArch)ts.getUserAgArch()).getJasonAgent();
                if (ts.getSettings().verbose()>1)
                        ts.getAg().getLogger().info("CALLING INTERNAL ACTION WITH STEEP: '"+protocolSteep+"'"+" CID: "+agentConversationID);

                /*
                 * When a FS Protocol is taking place*/
                if (protocolSteep.compareTo(Protocol_Template.START_STEP)==0){

                        String participant = getAtomAsString(args[1]);

                        timeOut = getTermAsInt(args[2]);                        

                        String initialInfo = getTermAsString(args[3]);

                        //building message template
                        ACLMessage msg = new ACLMessage();
                        msg.setProtocol("fipa-subscribe");

                        msg.setContent(initialInfo);
                        String factName = getFactoryName(agentConversationID,"FS",true);
                        //if (fsi == null){

                                fsi = new Jason_Fipa_Subscribe_Initiator(agName, ts);

                                String prevFactory = "";
                                if (Protocol_Factory!=null)
                                        prevFactory = Protocol_Factory.getName();
                                if (prevFactory.compareTo(factName)!=0) // if it is a new conversation a create a new one. This verification is not strictly 
                                        //necessary because it supposed that this condition will be always truth. This must be improved but, 
                                        //as the participants can not distinguish between conversation of the same factory also one factory per conversation 
                                        //is created with the initiator factory name as a filter. This implies one factory per conversation in the initiator too
                                {
                                        Protocol_Factory = fsi.newFactory(factName, null, 
                                                1, ((ConvMagentixAgArch)ts.getUserAgArch()).getJasonAgent(),timeOut);

                                /* The factory is setup to answer start conversation requests from the agent
                 using the FIPA_REQUEST protocol.*/
                                        ((ConvMagentixAgArch)ts.getUserAgArch()).getJasonAgent().addFactoryAsInitiator(Protocol_Factory);
                                }
                                
                        //}

                        /* finally the new conversation starts an asynchronous conversation.*/

                        myag.lock();
                        String ConvID = myag.newConvID();

                        FSConversation conv = new FSConversation(agentConversationID,ConvID,new AgentID(participant),initialInfo,
                                        ((ConvMagentixAgArch)ts.getUserAgArch()).getJasonAgent().getAid(),factName); 
                        ConvCProcessor processorTemplate = ((ConvCFactory)Protocol_Factory).cProcessorTemplate();
                        processorTemplate.setConversation(conv);
                        
                        msg.setConversationId(ConvID);
                        
                        ConvCProcessor convPprocessor =  myag.newConversation(msg, processorTemplate, false, Protocol_Factory);

                        convPprocessor.setConversation(conv);
                        
                        myag.unlock();

                        conversationsList.put(agentConversationID, conv);

                        
                }else
                        if (protocolSteep.compareTo(Protocol_Template.SUBSCRIBE_STEP)==0){
                                List<String> objects = getTermAsStringList(args[1]);
                                Iterator<String> itr = objects.iterator();
                                while (itr.hasNext())
                                {
                                        ((FSConversation)conversationsList.get(agentConversationID)).objects.put(itr.next(), "");
                                }
                                conversationsList.get(agentConversationID).release_semaphore(); 

                        }else
                                if(protocolSteep.compareTo(Protocol_Template.CANCEL_STEP)==0){
                                        ACLMessage cancelmsg = new ACLMessage();
                                        cancelmsg.setSender(myag.getAid());
                                        cancelmsg.setReceiver(myag.getAid());
                                        cancelmsg.setProtocol("fipa-subscribe");
                                        cancelmsg.setPerformative(ACLMessage.CANCEL);
                                        cancelmsg.setContent("Canceling conversation");
                                        cancelmsg.setConversationId(((FSConversation)conversationsList.get(agentConversationID)).internalConvID);
                                        //Message for getting out of the WAIT_FOR_INFORM state
                                        myag.send(cancelmsg);
                                }

                return true;

        }

Member Data Documentation


The documentation for this class was generated from the following file:
 All Classes Namespaces Files Functions Variables