de.fraunhofer.iese.ind2uce.reactive

Class AbstractRxPEP<T>

java.lang.Object

de.fraunhofer.iese.ind2uce.reactive.AbstractRxPEP<T>

All Implemented Interfaces:

RxPEP<T>

Direct Known Subclasses:

ReactivePEP

public abstract class AbstractRxPEP<T>
extends Object
implements RxPEP<T>

Base Implementation of a RxPEP.

Field Summary

Fields

Modifier and Type	Field and Description
protected Class<T>	pepInterfaceDescription The documentation API.
protected AtomicReference<RxPEPState>	pepState The pep state.
protected de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint	policyEnforcementPoint The policy enforcement point.

Constructor Summary

Constructors

Constructor and Description
AbstractRxPEP(de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint policyEnforcementPoint, Class<T> pepInterfaceDescription) Instantiates a new Rx PEP.

Method Summary

Modifier and Type	Method and Description
T	createInstanceAPI()
rx.Observable<Boolean>	doRegisterAtPMP() Registers the PEP at PMP.
protected abstract Object	enforceDecision(Method method, Object[] args)
de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint	getPolicyEnforcementPoint() It returns a valid instance of IPolicyEnforcementPoint
RxPEPState	isReady() Returns one of the following RxPEP states: REGISTRATION_DONE_SUCCESSFULLY: PEP is already registered at PMP. REGISTRATION_FAILED: PEP failed to register at PMP. REGISTRATION_NOT_STARTED: Registration has not been started yet and PEP needs to be initialized for the registration to be started. REGISTRATION_UNDER_PROCESS: Registration is being processed.
protected abstract void	postSuccessfulRegistration()
protected de.fraunhofer.iese.ind2uce.api.policy.Event	readAndCreateEvent(Method method, Object[] methodArguments) Gets the action id from the given method and creates a new event with specific UUID and parameters set.
protected de.fraunhofer.iese.ind2uce.api.policy.identifier.ActionId	readEventDescription(Method method) Gets the platform, context and action values from the event specification of the given method and creates the action id and returns it.
protected de.fraunhofer.iese.ind2uce.api.policy.parameter.ParameterList	readParameterList(Class<?>[] parametersType, Annotation[][] parametersAnnotations, Object[] methodArguments) Returns the annotations of type PEPParamKey with their corresponding method argument.

Methods inherited from class java.lang.Object

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

Field Detail

pepState

protected final AtomicReference<RxPEPState> pepState

The pep state.

policyEnforcementPoint

protected final de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint policyEnforcementPoint

The policy enforcement point.

pepInterfaceDescription

protected final Class<T> pepInterfaceDescription

The documentation API.

Constructor Detail

AbstractRxPEP

public AbstractRxPEP(de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint policyEnforcementPoint,
                     Class<T> pepInterfaceDescription)

Instantiates a new Rx PEP.

Parameters:

pepInterfaceDescription - the documentation API

policyEnforcementPoint - the policy enforcement point

Method Detail

createInstanceAPI

public T createInstanceAPI()

Specified by:

createInstanceAPI in interface RxPEP<T>

Returns:

the generic type

doRegisterAtPMP

public rx.Observable<Boolean> doRegisterAtPMP()

Description copied from interface: RxPEP

Registers the PEP at PMP.

Specified by:

doRegisterAtPMP in interface RxPEP<T>

Returns:

true if PEP is registered at PMP and returns false if PEP had been registered before or registration is failed.

enforceDecision

protected abstract Object enforceDecision(Method method,
                                          Object[] args)

getPolicyEnforcementPoint

public de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint getPolicyEnforcementPoint()

Description copied from interface: RxPEP

It returns a valid instance of IPolicyEnforcementPoint

Specified by:

getPolicyEnforcementPoint in interface RxPEP<T>

Returns:

IPolicyEnforcementPoint

isReady

public RxPEPState isReady()

Description copied from interface: RxPEP

Returns one of the following RxPEP states:

• REGISTRATION_DONE_SUCCESSFULLY: PEP is already registered at PMP.
• REGISTRATION_FAILED: PEP failed to register at PMP.
• REGISTRATION_NOT_STARTED: Registration has not been started yet and PEP needs to be initialized for the registration to be started.
• REGISTRATION_UNDER_PROCESS: Registration is being processed.

Specified by:

isReady in interface RxPEP<T>

Returns:

the current RxPEP state

postSuccessfulRegistration

protected abstract void postSuccessfulRegistration()

readAndCreateEvent

protected de.fraunhofer.iese.ind2uce.api.policy.Event readAndCreateEvent(Method method,
                                                                         Object[] methodArguments)
                                                                  throws IncorrectPEPDescriptionError

Gets the action id from the given method and creates a new event with specific UUID and parameters set.

Parameters:

method - the method

methodArguments - the method arguments

Returns:

the event

Throws:

IncorrectPEPDescriptionError - the incorrect PEP description error

readEventDescription

protected de.fraunhofer.iese.ind2uce.api.policy.identifier.ActionId readEventDescription(Method method)

Gets the platform, context and action values from the event specification of the given method and creates the action id and returns it.

Parameters:

method - the method

Returns:

the action id

readParameterList

protected de.fraunhofer.iese.ind2uce.api.policy.parameter.ParameterList readParameterList(Class<?>[] parametersType,
                                                                                          Annotation[][] parametersAnnotations,
                                                                                          Object[] methodArguments)

Returns the annotations of type PEPParamKey with their corresponding method argument.

Parameters:

parametersType - parameter type

parametersAnnotations - the parameters annotations

methodArguments - the method arguments

Returns:

the parameter list