com.madara.containers

Class Barrier

java.lang.Object

com.madara.MadaraJNI

com.madara.containers.BaseContainer

com.madara.containers.Barrier

public class Barrier
extends BaseContainer

A facade for a distributed barrier within a knowledge base

Constructor Summary

Constructors

Constructor and Description
Barrier() Default constructor
Barrier(Barrier input) Copy constructor

Method Summary

Modifier and Type	Method and Description
protected void	finalize() Cleans up underlying C resources
void	free() Deletes the C instantiation.
static Barrier	fromPointer(long cptr) Creates a java object instance from a C/C++ pointer
static Barrier	fromPointer(long cptr, boolean shouldManage) Creates a java object instance from a C/C++ pointer
long	get() Gets the value
java.lang.String	getName() Gets the name of the variable
boolean	isDone() Checks to see if the barrier round is done
boolean	isFalse() Returns true if the container evaluates to false
boolean	isTrue() Returns true if the container evaluates to true
void	modify() Mark the value as modified.
void	next() Moves to the next barrier
void	resize(int id, int participants) Resizes the barrier, usually when number of participants change
void	setName(KnowledgeBase kb, java.lang.String name, int id, int participants) Sets the name and knowledge base being referred to
void	setName(Variables vars, java.lang.String name, int id, int participants) Sets the name and knowledge base being referred to
void	setSettings(UpdateSettings settings) Sets the settings for updating variables in the Knowledge Base
double	toDouble() Converts the value to a double
long	toLong() Converts the value to a long
java.lang.String	toString() Converts the value to a string

Methods inherited from class com.madara.containers.BaseContainer

modifyIfFalse, modifyIfTrue

Methods inherited from class com.madara.MadaraJNI

getCPtr, setCPtr

Methods inherited from class java.lang.Object

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

Constructor Detail

Barrier

public Barrier()

Default constructor

Barrier

public Barrier(Barrier input)

Copy constructor

Parameters:

input - instance to copy

Method Detail

fromPointer

public static Barrier fromPointer(long cptr)

Creates a java object instance from a C/C++ pointer

Parameters:

cptr - C pointer to the object

Returns:

a new java instance of the underlying pointer

fromPointer

public static Barrier fromPointer(long cptr,
                                  boolean shouldManage)

Creates a java object instance from a C/C++ pointer

Parameters:

cptr - C pointer to the object

shouldManage - if true, manage the pointer

Returns:

a new java instance of the underlying pointer

get

public long get()

Gets the value

Returns:

current value

getName

public java.lang.String getName()

Gets the name of the variable

Returns:

name of the variable within the context

next

public void next()

Moves to the next barrier

isDone

public boolean isDone()

Checks to see if the barrier round is done

Returns:

new value of the container

modify

public void modify()

Mark the value as modified. The Barrier retains the same value but will resend its value as if it had been modified.

resize

public void resize(int id,
                   int participants)

Resizes the barrier, usually when number of participants change

Parameters:

id - the id of this barrier in the barrier ring

participants - the number of participants in barrier ring

setName

public void setName(KnowledgeBase kb,
                    java.lang.String name,
                    int id,
                    int participants)

Sets the name and knowledge base being referred to

Parameters:

kb - the knowledge base that contains the name

name - the variable name

id - the id of the barrier in the barrier ring

participants - the number of participants in the barrier ring

setName

public void setName(Variables vars,
                    java.lang.String name,
                    int id,
                    int participants)

Sets the name and knowledge base being referred to

Parameters:

vars - the variables facade that contains the name

name - the variable name

id - the id of the barrier in the barrier ring

participants - the number of participants in the barrier ring

setSettings

public void setSettings(UpdateSettings settings)

Sets the settings for updating variables in the Knowledge Base

Parameters:

settings - the settings to use for updating the Knowledge Base

toDouble

public double toDouble()

Converts the value to a double

Returns:

current double value

toLong

public long toLong()

Converts the value to a long

Returns:

current long value

isTrue

public boolean isTrue()

Returns true if the container evaluates to true

Returns:

true if container has all true values

isFalse

public boolean isFalse()

Returns true if the container evaluates to false

Returns:

true if container has any false values or is uninitialized

toString

public java.lang.String toString()

Converts the value to a string

Overrides:

toString in class MadaraJNI

Returns:

current string value

See Also:

()

free

public void free()

Deletes the C instantiation. To prevent memory leaks, this must be called before an instance gets garbage collected

finalize

protected void finalize()
                 throws java.lang.Throwable

Cleans up underlying C resources

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable - necessary for override but unused