org.snmp4j.agent
Interface MOQuery

All Known Implementing Classes:

DefaultMOQuery, MOQueryWithSource

public interface MOQuery

A managed object query is used to lookup managed objects, for example in a MOServer repository.

Version:

1.1

Author:

Frank Fock

Method Summary

MOContextScope	getScope() Gets the search range of this query.
boolean	isWriteAccessQuery() Indicates whether this query is issued on behalf of an intended write access on the ManagedObjects matched by this query.
boolean	matchesQuery(ManagedObject managedObject) Checks whether a managed object matches the internal query criteria defined by this query.
void	substractScope(MOScope scope) Changes the query to no longer match (cover) the specified scope.

Method Detail

getScope

MOContextScope getScope()

Gets the search range of this query.

Returns:

a MORange instance denoting upper and lower bound of this queries scope.

matchesQuery

boolean matchesQuery(ManagedObject managedObject)

Checks whether a managed object matches the internal query criteria defined by this query.

Parameters:

managedObject - the ManagedObject instance to check.

Returns:

true if the managedObject matches the query.

substractScope

void substractScope(MOScope scope)

Changes the query to no longer match (cover) the specified scope. If the query's scope is immutable (does not implement the MutableMOScope interface, then this method will throw an UnsupportedOperationException.

Parameters:

scope - a MOScope instance that defines the range of OIDs that should be no longer in the scope of this query.

isWriteAccessQuery

boolean isWriteAccessQuery()

Indicates whether this query is issued on behalf of an intended write access on the ManagedObjects matched by this query. This information can be used to optimize query evaluation or to control resource allocation.

Returns:

true if this query is performed to change or create a managed object matching this query and false if the query is for read-only access on the matched managed objects.

Since:

1.1