jade.semantics.kbase

Class QueryResult

java.lang.Object

jade.semantics.kbase.QueryResult

public class QueryResult
extends Object

The QueryResult class reifies the result of a query done onto the KBase object of an agent. Such a result can be : - null if the queried fact is not believed by the agent, -
an empty QueryResult if the queried fact is believed by the agent and includes no meta-reference,
-
a QueryResult holding MatchResult if the queried fact is believed by the agent and includes meta-reference.

Author:

Thierry Martinez - France Telecom

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	QueryResult.BoolWrapper

Field Summary

Fields

Modifier and Type	Field and Description
static QueryResult	KNOWN
private ArrayList	results
static QueryResult	UNKNOWN

Constructor Summary

Constructors

Constructor and Description
QueryResult() Constructor.
QueryResult(ArrayList results) Constructor.
QueryResult(MatchResult result) Constructor.
QueryResult(QueryResult queryResult) Constructor.

Method Summary

Modifier and Type	Method and Description
void	add(MatchResult result) This method add a given result if not already in the results list.
void	addAll(ArrayList results) This method add all the results if not already in the results list.
static ArrayList	addReasons(ArrayList reasons, ArrayList list)
boolean	equals(Object qr)
MatchResult	getResult(int index)
ArrayList	getResults()
boolean	isEmpty()
MatchResult	remove(int i)
void	remove(MatchResult result) This method remove a given result from the results list.
(package private) void	removeSubsumedMatchResult()
int	size()
String	toString()
QueryResult	union(QueryResult other) Returns the union between this list of match results and the other one given as an argument

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

UNKNOWN

public static final QueryResult UNKNOWN

KNOWN

public static final QueryResult KNOWN

results

private ArrayList results

Constructor Detail

QueryResult

public QueryResult()

Constructor.

QueryResult

public QueryResult(MatchResult result)

Constructor.

QueryResult

public QueryResult(ArrayList results)

Constructor.

QueryResult

public QueryResult(QueryResult queryResult)

Constructor.

Method Detail

addReasons

public static ArrayList addReasons(ArrayList reasons,
                                   ArrayList list)

getResults

public ArrayList getResults()

Returns:

An ArrayList of MatchResult

getResult

public MatchResult getResult(int index)

Returns:

The index MatchResult

add

public void add(MatchResult result)

This method add a given result if not already in the results list.

Parameters:

result - The MatchResult to add.

addAll

public void addAll(ArrayList results)

This method add all the results if not already in the results list.

Parameters:

results - The MatchResults to add.

remove

public void remove(MatchResult result)

This method remove a given result from the results list.

Parameters:

result - The MatchResult to remove.

remove

public MatchResult remove(int i)

size

public int size()

Returns:

the size of this result

isEmpty

public boolean isEmpty()

Returns:

true if it is an empt result (equivalent to size() == 0)

equals

public boolean equals(Object qr)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

union

public QueryResult union(QueryResult other)

Returns the union between this list of match results and the other one given as an argument

Parameters:

other -

Returns:

the union between this list of match results and the other one given as an argument

removeSubsumedMatchResult

void removeSubsumedMatchResult()