uk.ac.manchester.cs.jfact.kernel

Class RoleAutomaton

java.lang.Object

uk.ac.manchester.cs.jfact.kernel.RoleAutomaton

All Implemented Interfaces:

Serializable

@PortedFrom(file="RAutomaton.h",
            name="RoleAutomaton")
public class RoleAutomaton
extends Object
implements Serializable

role automaton

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	FINAL_STATE get the final state
static int	INITIAL get the initial state

Constructor Summary

Constructors

Constructor and Description
RoleAutomaton() Default constructor.

Method Summary

Modifier and Type	Method and Description
void	addCopy(RoleAutomaton ra)
void	addRA(RoleAutomaton ra) add RA from a subrole to given one
boolean	addToChain(RoleAutomaton ra, boolean oSafe) add an Automaton to the chain with a default state
boolean	addToChain(RoleAutomaton ra, boolean oSafe, int fRA) add an Automaton to the chain that would start from the iRA; OSAFE shows the safety of a previous automaton in a chain
void	addTransition(int from, RATransition trans) add TRANSition leading from a state FROM; all states are known to fit the ton
void	addTransitionSafe(int state, RATransition trans) add TRANSition leading from a given STATE; check whether all states are correct
void	checkTransition(int from, int to) check whether transition between FROM and TO breaks safety
RAStateTransitions	get(int i)
List<RAStateTransitions>	getBase()
RAStateTransitions	getRAStateTransitions(int state)
void	initChain(int from) make the beginning of the chain
void	initMap(int raSize, int fra) init internal map according to RA size, with new initial state from chainState and (FRA) states
boolean	isCompleted()
boolean	isISafe()
boolean	isOSafe()
boolean	isSimple()
int	newState()
void	nextChainTransition(int to) make the internal chain transition (between chainState and TO)
void	print(LogAdapter o)
void	setCompleted(boolean b) mark an automaton as completed
void	setIUnsafe() state that the automaton is i-unsafe
void	setOUnsafe() state that the automaton is o-unsafe
void	setup(int nRoles, boolean data) set up all transitions passing number of roles
int	size()

Methods inherited from class java.lang.Object

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

Field Detail

INITIAL

@Original
public static final int INITIAL

get the initial state

See Also:

Constant Field Values

FINAL_STATE

@PortedFrom(file="RAutomaton.h",
            name="final")
public static final int FINAL_STATE

get the final state

See Also:

Constant Field Values

Constructor Detail

RoleAutomaton

public RoleAutomaton()

Default constructor.

Method Detail

initChain

@PortedFrom(file="RAutomaton.h",
            name="initChain")
public void initChain(int from)

make the beginning of the chain

Parameters:

from - from

addToChain

@PortedFrom(file="RAutomaton.h",
            name="addToChain")
public boolean addToChain(RoleAutomaton ra,
                                                                                          boolean oSafe)

add an Automaton to the chain with a default state

Parameters:

ra - RA

oSafe - oSafe

Returns:

is o safe

isISafe

@PortedFrom(file="RAutomaton.h",
            name="isISafe")
public boolean isISafe()

Returns:

the i-safe value

isOSafe

@PortedFrom(file="RAutomaton.h",
            name="isOSafe")
public boolean isOSafe()

Returns:

the o-safe value

addRA

@PortedFrom(file="RAutomaton.h",
            name="addRA")
public void addRA(RoleAutomaton ra)

add RA from a subrole to given one

Parameters:

ra - RA

addTransitionSafe

@PortedFrom(file="RAutomaton.h",
            name="addTransitionSafe")
public void addTransitionSafe(int state,
                                                                                                     RATransition trans)

add TRANSition leading from a given STATE; check whether all states are correct

Parameters:

state - state

trans - trans

setIUnsafe

@PortedFrom(file="RAutomaton.h",
            name="setIUnsafe")
public void setIUnsafe()

state that the automaton is i-unsafe

setOUnsafe

@PortedFrom(file="RAutomaton.h",
            name="setOUnsafe")
public void setOUnsafe()

state that the automaton is o-unsafe

checkTransition

@PortedFrom(file="RAutomaton.h",
            name="checkTransition")
public void checkTransition(int from,
                                                                                                 int to)

check whether transition between FROM and TO breaks safety

Parameters:

from - from

to - to

addTransition

@PortedFrom(file="RAutomaton.h",
            name="addTransition")
public void addTransition(int from,
                                                                                             RATransition trans)

add TRANSition leading from a state FROM; all states are known to fit the ton

Parameters:

from - from

trans - trans

nextChainTransition

@PortedFrom(file="RAutomaton.h",
            name="nextChainTransition")
public void nextChainTransition(int to)

make the internal chain transition (between chainState and TO)

Parameters:

to - to

newState

@PortedFrom(file="RAutomaton.h",
            name="newState")
public int newState()

Returns:

new state

getRAStateTransitions

@PortedFrom(file="RAutomaton.h",
            name="begin")
public RAStateTransitions getRAStateTransitions(int state)

Parameters:

state - state

Returns:

the 1st (multi-)transition starting in STATE

size

@PortedFrom(file="RAutomaton.h",
            name="size")
public int size()

Returns:

number of distinct states

setup

@PortedFrom(file="RAutomaton.h",
            name="setup")
public void setup(int nRoles,
                                                                             boolean data)

set up all transitions passing number of roles

Parameters:

nRoles - nRoles

data - data

print

@PortedFrom(file="RAutomaton.h",
            name="print")
public void print(LogAdapter o)

Parameters:

o - o

addCopy

@PortedFrom(file="RAutomaton.h",
            name="addCopy")
public void addCopy(RoleAutomaton ra)

Parameters:

ra - RA

initMap

@PortedFrom(file="RAutomaton.h",
            name="initMap")
public void initMap(int raSize,
                                                                                 int fra)

init internal map according to RA size, with new initial state from chainState and (FRA) states

Parameters:

raSize - RASize

fra - fRA

addToChain

@PortedFrom(file="RAutomaton.h",
            name="addToChain")
public boolean addToChain(RoleAutomaton ra,
                                                                                          boolean oSafe,
                                                                                          int fRA)

add an Automaton to the chain that would start from the iRA; OSAFE shows the safety of a previous automaton in a chain

Parameters:

ra - RA

oSafe - oSafe

fRA - fRA

Returns:

is o safe

getBase

@PortedFrom(file="RAutomaton.h",
            name="begin")
public List<RAStateTransitions> getBase()

Returns:

state transitions

get

@PortedFrom(file="RAutomaton.h",
            name="begin")
public RAStateTransitions get(int i)

Parameters:

i - index

Returns:

transitions

setCompleted

@PortedFrom(file="RAutomaton.h",
            name="setCompleted")
public void setCompleted(boolean b)

mark an automaton as completed

Parameters:

b - new value

isCompleted

@PortedFrom(file="RAutomaton.h",
            name="isCompleted")
public boolean isCompleted()

Returns:

check whether automaton is completed

isSimple

@PortedFrom(file="RAutomaton.h",
            name="isSimple")
public boolean isSimple()

Returns:

true iff the automaton is simple