- java.lang.Object
-
- org.snmp4j.agent.DefaultMOScope
-
- All Implemented Interfaces:
MOScope
,MutableMOScope
- Direct Known Subclasses:
DefaultMOContextScope
public class DefaultMOScope extends Object implements MOScope, MutableMOScope
- Version:
- 1.0
- Author:
- Frank Fock
-
-
Field Summary
Fields Modifier and Type Field Description protected org.snmp4j.smi.OID
lowerBound
protected boolean
lowerIncluded
protected org.snmp4j.smi.OID
upperBound
protected boolean
upperIncluded
-
Constructor Summary
Constructors Constructor Description DefaultMOScope(MOScope other)
Creates a scope from another scope by referencing its bound values.DefaultMOScope(org.snmp4j.smi.OID lowerBound, boolean lowerIncluded, org.snmp4j.smi.OID upperBound, boolean upperIncluded)
Creates an OID scope from lower and upper bound.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
covers(MOScope covered)
Indicates whether this scope covers by the supplied one, that is whether the lower bound of this scope is less or equal to the lower bound of the covered scope and if the upper bound is greater or equal to the upper bound of the covered scope.static boolean
covers(MOScope scope, MOScope covered)
Indicates whether the first supplied scope covers by second one.boolean
covers(org.snmp4j.smi.OID oid)
Checks if this scope covers the supplied OID.boolean
equals(Object obj)
org.snmp4j.smi.OID
getLowerBound()
Gets the lower bound OID of the scope.org.snmp4j.smi.OID
getUpperBound()
Gets the upper bound OID of the scope.int
hashCode()
boolean
isCovered(MOScope other)
Checks whether the supplied scope is covered by this scope.boolean
isEmpty()
Checks if this scope is empty or not.boolean
isLowerIncluded()
Indicates whether the lower bound OID is included in the scope or not.boolean
isOverlapping(MOScope other)
Checks whether the supplied scope overlap with this one, thus sharing at least one OID with the supplied one.boolean
isUpperIncluded()
Indicates whether the upper bound OID is included in the scope or not.static boolean
overlaps(MOScope scope, MOScope intersected)
Indicates whether the first scope supplied overlaps with the second one.void
setLowerBound(org.snmp4j.smi.OID lowerBound)
Sets the lower bound OID of the scope.void
setLowerIncluded(boolean lowerIncluded)
Sets the flag specifying whether the lower bound OID is included in the scope or not.void
setUpperBound(org.snmp4j.smi.OID upperBound)
Sets the upper bound OID of the scope (can benull
for an unbounded scope.void
setUpperIncluded(boolean upperIncluded)
Sets the flag specifying whether the upper bound OID is included in the scope or not.void
substractScope(MOScope scope)
Changes the scope to no longer cover any elements in covered by the specified scope.String
toString()
-
-
-
Constructor Detail
-
DefaultMOScope
public DefaultMOScope(org.snmp4j.smi.OID lowerBound, boolean lowerIncluded, org.snmp4j.smi.OID upperBound, boolean upperIncluded)
Creates an OID scope from lower and upper bound.- Parameters:
lowerBound
- the lower bound of the scope.lowerIncluded
- indicates whether the lower bound is included in the scope or not.upperBound
- the upper bound of the scope,null
can be specified to set no upper limit.upperIncluded
- indicates whether the upper bound is included in the scope or not.
-
DefaultMOScope
public DefaultMOScope(MOScope other)
Creates a scope from another scope by referencing its bound values.- Parameters:
other
- another scope.
-
-
Method Detail
-
getLowerBound
public org.snmp4j.smi.OID getLowerBound()
Description copied from interface:MOScope
Gets the lower bound OID of the scope. Whether the lower bound is included or excluded from the scope's region is determined byMOScope.isLowerIncluded()
.- Specified by:
getLowerBound
in interfaceMOScope
- Returns:
- an OID.
-
getUpperBound
public org.snmp4j.smi.OID getUpperBound()
Description copied from interface:MOScope
Gets the upper bound OID of the scope. Whether the upper bound is included or excluded from the scope's region is determined byMOScope.isUpperIncluded()
.- Specified by:
getUpperBound
in interfaceMOScope
- Returns:
- OID
-
isLowerIncluded
public boolean isLowerIncluded()
Description copied from interface:MOScope
Indicates whether the lower bound OID is included in the scope or not.- Specified by:
isLowerIncluded
in interfaceMOScope
- Returns:
true
if the lower bound is included.
-
isUpperIncluded
public boolean isUpperIncluded()
Description copied from interface:MOScope
Indicates whether the upper bound OID is included in the scope or not.- Specified by:
isUpperIncluded
in interfaceMOScope
- Returns:
true
if the upper bound is included.
-
isCovered
public boolean isCovered(MOScope other)
Description copied from interface:MOScope
Checks whether the supplied scope is covered by this scope.
-
isOverlapping
public boolean isOverlapping(MOScope other)
Description copied from interface:MOScope
Checks whether the supplied scope overlap with this one, thus sharing at least one OID with the supplied one.- Specified by:
isOverlapping
in interfaceMOScope
- Parameters:
other
- aMOScope
.- Returns:
true
if there exists at least one OID that is included in both scopes.
-
setLowerBound
public void setLowerBound(org.snmp4j.smi.OID lowerBound)
Description copied from interface:MutableMOScope
Sets the lower bound OID of the scope.- Specified by:
setLowerBound
in interfaceMutableMOScope
- Parameters:
lowerBound
- an OID.
-
setLowerIncluded
public void setLowerIncluded(boolean lowerIncluded)
Description copied from interface:MutableMOScope
Sets the flag specifying whether the lower bound OID is included in the scope or not.- Specified by:
setLowerIncluded
in interfaceMutableMOScope
- Parameters:
lowerIncluded
-true
if the lower bound is included,false
otherwise.
-
setUpperBound
public void setUpperBound(org.snmp4j.smi.OID upperBound)
Description copied from interface:MutableMOScope
Sets the upper bound OID of the scope (can benull
for an unbounded scope.- Specified by:
setUpperBound
in interfaceMutableMOScope
- Parameters:
upperBound
- an OID ornull
.
-
setUpperIncluded
public void setUpperIncluded(boolean upperIncluded)
Description copied from interface:MutableMOScope
Sets the flag specifying whether the upper bound OID is included in the scope or not. This flag has no effect ifupperBound
isnull
.- Specified by:
setUpperIncluded
in interfaceMutableMOScope
- Parameters:
upperIncluded
-true
if the upper bound is included,false
otherwise.
-
covers
public boolean covers(MOScope covered)
Indicates whether this scope covers by the supplied one, that is whether the lower bound of this scope is less or equal to the lower bound of the covered scope and if the upper bound is greater or equal to the upper bound of the covered scope.- Parameters:
covered
- a MOScope instance.- Returns:
true
if this OID scope covers the supplied one.
-
covers
public static boolean covers(MOScope scope, MOScope covered)
Indicates whether the first supplied scope covers by second one.- Parameters:
scope
- the covering scope.covered
- the covered scope.- Returns:
true
if the lower bound ofscope
is less or equal to the lower bound ofcovered
and if the upper bound is greater or equal to the upper bound ofcovered
.
-
overlaps
public static boolean overlaps(MOScope scope, MOScope intersected)
Indicates whether the first scope supplied overlaps with the second one. If both scopes are instances of MOContextScope their context must match- Parameters:
scope
- a MOScope instance.intersected
- the presumable intersected MOScope.- Returns:
true
ifscope
overlaps any bound ofintersected
. This is always the case, if the upper bound of both scopes isnull
.
-
substractScope
public void substractScope(MOScope scope)
Description copied from interface:MutableMOScope
Changes the scope to no longer cover any elements in covered by the specified scope.- Specified by:
substractScope
in interfaceMutableMOScope
- Parameters:
scope
- aMOScope
instance that defines the range of OIDs that should be no longer in this scope.
-
covers
public boolean covers(org.snmp4j.smi.OID oid)
Description copied from interface:MOScope
Checks if this scope covers the supplied OID.
-
isEmpty
public boolean isEmpty()
Checks if this scope is empty or not. An empty scope cannot cover any OID (i.e. lower bound is greater than upper bound).- Returns:
true
if lower bound is greater than upper bound or if both bounds equal but one of the bounds is not-included.
-
-