Module org.snmp4j.agent

Package org.snmp4j.agent

Class MOQueryWithSource

java.lang.Object

org.snmp4j.agent.DefaultMOQuery

org.snmp4j.agent.MOQueryWithSource

All Implemented Interfaces:

MOContextScope, MOQuery, MOScope

public class MOQueryWithSource
extends DefaultMOQuery

The MOQueryWithSource class is the implementation of a managed object query for a Request. It is used to lookup managed objects, for example in a MOServer repository.

Since:

2.0

Version:

2.0

Author:

Frank Fock

Constructor Summary

Constructors

Constructor	Description
MOQueryWithSource(MOContextScope scope, boolean isWriteAccessIntended, Object source)	Creates a context aware query from a context aware OID scope.

Method Summary

Modifier and Type	Method	Description
Object	getSource()	Gets the source (Request) object on whose behalf this query is executed.
static boolean	isSameSource(MOQuery query, Object source)	This method checks whether the supplied query and the given source reference refer to the same source (request).

Methods inherited from class org.snmp4j.agent.DefaultMOQuery

covers, getContext, getLowerBound, getScope, getUpperBound, isCovered, isLowerIncluded, isOverlapping, isUpperIncluded, isWriteAccessQuery, matchesQuery, subtractScope, toString

Methods inherited from class java.lang.Object

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

Constructor Details

MOQueryWithSource

public MOQueryWithSource(MOContextScope scope,
 boolean isWriteAccessIntended,
 Object source)

Creates a context aware query from a context aware OID scope.

Parameters:

scope - a scope that defines the possible result set of OIDs from a specific context for this query.

isWriteAccessIntended - indicates whether this query serves a write access on ManagedObjects or not.

source - the Request on whose behalf this query is being executed.

Since:

2.0

Method Details

getSource

public Object getSource()

Gets the source (Request) object on whose behalf this query is executed. This object reference can be used to determine whether a query needs to update ManagedObject content or not. When the reference is the same as those from the last query then an update is not necessary.

Overrides:

getSource in class DefaultMOQuery

Returns:

an Object on whose behalf this query is executed which will be in most cases a Request instance, but code should not rely on that. If null is returned, the query source cannot be determined.

Since:

1.1

isSameSource

public static boolean isSameSource(MOQuery query,
 Object source)

This method checks whether the supplied query and the given source reference refer to the same source (request).

Parameters:

query - a MOQuery instance.

source - any source object reference.

Returns:

true only if query is a DefaultMOQuery instance and getSource()== source and source is not null.

Since:

1.1