Package jason.bb

Class DefaultBeliefBase

java.lang.Object

jason.bb.BeliefBase

jason.bb.DefaultBeliefBase

All Implemented Interfaces:

ToDOM, Serializable, Cloneable, Iterable<Literal>

public class DefaultBeliefBase
extends BeliefBase
implements Serializable

Default implementation of Jason BB.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected Set<Literal>	percepts	set of beliefs with percept annot, used to improve performance of buf

Fields inherited from class jason.bb.BeliefBase

APercept, ASelf, TPercept, TSelf

Constructor Summary

Constructors

Constructor	Description
DefaultBeliefBase()

Method Summary

Modifier and Type	Method	Description
boolean	abolish(Atom namespace, PredicateIndicator pi)
boolean	add(int index, Literal l)	Adds a belief in the BB at index position, returns true if succeed
boolean	add(Literal l)	Adds a belief in the end of the BB, returns true if succeed.
protected boolean	add(Literal l, boolean addInEnd)
void	clear()	removes all beliefs from BB
BeliefBase	clone()
Literal	contains(Literal l)	Returns the literal l as it is in BB, this method does not consider annotations in the search.
Element	getAsDOM(Document document)	Gets the BB as XML
Iterator<Literal>	getCandidateBeliefs(Literal l, Unifier u)	Returns an iterator for all literals relevant for l's predicate indicator, if l is a var, returns all beliefs. The unifier u may contain values for variables in l.
Iterator<Literal>	getCandidateBeliefs(PredicateIndicator pi)	Returns an iterator for all literals in the default namespace of the BB that match the functor/arity of the parameter.
Term	getNameSpaceProp(Atom ns, Atom key)
Set<Atom>	getNameSpaceProps(Atom ns)
Set<Atom>	getNameSpaces()
Iterator<Literal>	getPercepts()	Returns all beliefs that have "percept" as source
void	init(Agent ag, String[] args)	Called before the MAS execution with the agent that uses this BB and the args informed in .mas2j project. Example in .mas2j: agent BeliefBaseClass(1,bla); the init args will be ["1", "bla"].
Iterator<Literal>	iterator()	Returns an iterator for all beliefs.
boolean	remove(Literal l)	Removes a literal from BB, returns true if succeed
void	setNameSpaceProp(Atom ns, Atom key, Term value)
int	size()	Returns the number of beliefs in BB
String	toString()

Methods inherited from class jason.bb.BeliefBase

abolish, getLock, stop

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Details

percepts

protected Set<Literal> percepts

set of beliefs with percept annot, used to improve performance of buf

Constructor Details

DefaultBeliefBase

public DefaultBeliefBase()

Method Details

init

public void init(Agent ag,
 String[] args)

Description copied from class: BeliefBase

Called before the MAS execution with the agent that uses this BB and the args informed in .mas2j project.
Example in .mas2j:
agent BeliefBaseClass(1,bla);
the init args will be ["1", "bla"].

Overrides:

init in class BeliefBase

getNameSpaces

public Set<Atom> getNameSpaces()

Overrides:

getNameSpaces in class BeliefBase

setNameSpaceProp

public void setNameSpaceProp(Atom ns,
 Atom key,
 Term value)

Overrides:

setNameSpaceProp in class BeliefBase

getNameSpaceProp

public Term getNameSpaceProp(Atom ns,
 Atom key)

Overrides:

getNameSpaceProp in class BeliefBase

getNameSpaceProps

public Set<Atom> getNameSpaceProps(Atom ns)

Overrides:

getNameSpaceProps in class BeliefBase

size

public int size()

Description copied from class: BeliefBase

Returns the number of beliefs in BB

Overrides:

size in class BeliefBase

clear

public void clear()

Description copied from class: BeliefBase

removes all beliefs from BB

Overrides:

clear in class BeliefBase

getPercepts

public Iterator<Literal> getPercepts()

Description copied from class: BeliefBase

Returns all beliefs that have "percept" as source

Overrides:

getPercepts in class BeliefBase

add

public boolean add(Literal l)
            throws JasonException

Description copied from class: BeliefBase

Adds a belief in the end of the BB, returns true if succeed. The annots of l may be changed to reflect what was changed in the BB, for example, if l is p[a,b] in a BB with p[a], l will be changed to p[b] to produce the event +p[b], since only the annotation b is changed in the BB.

Overrides:

add in class BeliefBase

Throws:

JasonException

add

public boolean add(int index,
 Literal l)
            throws JasonException

Description copied from class: BeliefBase

Adds a belief in the BB at index position, returns true if succeed

Overrides:

add in class BeliefBase

Throws:

JasonException

add

protected boolean add(Literal l,
 boolean addInEnd)
               throws JasonException

Throws:

JasonException

remove

public boolean remove(Literal l)

Description copied from class: BeliefBase

Removes a literal from BB, returns true if succeed

Overrides:

remove in class BeliefBase

iterator

public Iterator<Literal> iterator()

Description copied from class: BeliefBase

Returns an iterator for all beliefs.

Specified by:

iterator in interface Iterable<Literal>

Specified by:

iterator in class BeliefBase

abolish

public boolean abolish(Atom namespace,
 PredicateIndicator pi)

Overrides:

abolish in class BeliefBase

contains

public Literal contains(Literal l)

Description copied from class: BeliefBase

Returns the literal l as it is in BB, this method does not consider annotations in the search.
Example, if BB={a(10)[a,b]}, contains(a(10)[d]) returns a(10)[a,b].

Overrides:

contains in class BeliefBase

getCandidateBeliefs

public Iterator<Literal> getCandidateBeliefs(PredicateIndicator pi)

Description copied from class: BeliefBase

Returns an iterator for all literals in the default namespace of the BB that match the functor/arity of the parameter.

Specified by:

getCandidateBeliefs in class BeliefBase

getCandidateBeliefs

public Iterator<Literal> getCandidateBeliefs(Literal l,
 Unifier u)

Description copied from class: BeliefBase

Returns an iterator for all literals relevant for l's predicate indicator, if l is a var, returns all beliefs.
The unifier u may contain values for variables in l. Example, if BB={a(10),a(20),a(2,1),b(f)}, then getCandidateBeliefs(a(5), {}) = {{a(10),a(20)}.
if BB={a(10),a(20)}, then getCandidateBeliefs(X) = {{a(10),a(20)}. The getCandidateBeliefs(a(X), {X -> 5}) should also return {{a(10),a(20)}.

Overrides:

getCandidateBeliefs in class BeliefBase

toString

public String toString()

Overrides:

toString in class Object

clone

public BeliefBase clone()

Specified by:

clone in class BeliefBase

getAsDOM

public Element getAsDOM(Document document)

Description copied from class: BeliefBase

Gets the BB as XML

Specified by:

getAsDOM in interface ToDOM

Overrides:

getAsDOM in class BeliefBase