Class EndpointPermission
java.lang.Object
java.security.Permission
org.osgi.service.remoteserviceadmin.EndpointPermission
- All Implemented Interfaces:
Serializable,Guard
A bundle's authority to export, import or read an Endpoint.
- The
exportaction allows a bundle to export a service as an Endpoint. - The
importaction allows a bundle to import a service from an Endpoint. - The
readaction allows a bundle to read references to an Endpoint.
EndpointPermission to read the specific service.- See Also:
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionEndpointPermission(String filterString, String actions) Create a new EndpointPermission with the specified filter.EndpointPermission(EndpointDescription endpoint, String localFrameworkUUID, String actions) Creates a new requestedEndpointPermissionobject to be used by code that must performcheckPermission. -
Method Summary
Modifier and TypeMethodDescriptionbooleanDetermines the equality of two EndpointPermission objects.Returns the canonical string representation of the actions.inthashCode()Returns the hash code value for this object.booleanDetermines if aEndpointPermissionobject "implies" the specified permission.Returns a newPermissionCollectionobject for storingEndpointPermissionobjects.Methods inherited from class java.security.Permission
checkGuard, getName, toString
-
Field Details
-
READ
The action stringread.- See Also:
-
IMPORT
The action stringimport. Theimportaction implies thereadaction.- See Also:
-
EXPORT
The action stringexport. Theexportaction implies thereadaction.- See Also:
-
-
Constructor Details
-
EndpointPermission
Create a new EndpointPermission with the specified filter.The filter will be evaluated against the endpoint properties of a requested EndpointPermission.
There are three possible actions:
read,importandexport. Thereadaction allows the owner of this permission to see the presence of distributed services. Theimportaction allows the owner of this permission to import an endpoint. Theexportaction allows the owner of this permission to export a service.- Parameters:
filterString- The filter string or "*" to match all endpoints.actions- The actionsread,import, orexport.- Throws:
IllegalArgumentException- If the filter has an invalid syntax or the actions are not valid.
-
EndpointPermission
Creates a new requestedEndpointPermissionobject to be used by code that must performcheckPermission.EndpointPermissionobjects created with this constructor cannot be added to anEndpointPermissionpermission collection.- Parameters:
endpoint- The requested endpoint.localFrameworkUUID- The UUID of the local framework. This is used to support matching theendpoint.framework.uuidendpoint property to the<<LOCAL>>value in the filter expression.actions- The actionsread,import, orexport.- Throws:
IllegalArgumentException- If the endpoint isnullor the actions are not valid.
-
-
Method Details
-
implies
Determines if aEndpointPermissionobject "implies" the specified permission.- Specified by:
impliesin classPermission- Parameters:
p- The target permission to check.- Returns:
trueif the specified permission is implied by this object;falseotherwise.
-
getActions
Returns the canonical string representation of the actions. Always returns present actions in the following canonical order:read,import,export.- Specified by:
getActionsin classPermission- Returns:
- The canonical string representation of the actions.
-
newPermissionCollection
Returns a newPermissionCollectionobject for storingEndpointPermissionobjects.- Overrides:
newPermissionCollectionin classPermission- Returns:
- A new
PermissionCollectionobject suitable for storingEndpointPermissionobjects.
-
equals
Determines the equality of two EndpointPermission objects. Checks that specified object has the same name, actions and endpoint as thisEndpointPermission.- Specified by:
equalsin classPermission- Parameters:
obj- The object to test for equality.- Returns:
- true If obj is a
EndpointPermission, and has the same name, actions and endpoint as thisEndpointPermissionobject;falseotherwise.
-
hashCode
public int hashCode()Returns the hash code value for this object.- Specified by:
hashCodein classPermission- Returns:
- Hash code value for this object.
-