Package org.eolang

Class UniverseSafe

java.lang.Object

org.eolang.UniverseSafe

All Implemented Interfaces:

Universe

public final class UniverseSafe
extends Object
implements Universe

Universe to be used from within native function.

Since we cannot save stacktrace of exception inside native code (we can only detect it), we should keep it on the java side. More detailed: www.developer.com/open-source/exception-handling-in-jni, stackoverflow.com/questions/2054598/how-to-catch-jni-java-exception, www.iitk.ac.in/esc101/05Aug/tutorial/native1.1/implementing/error.html

Since:

0.32

Constructor Summary

Constructors

Constructor	Description
UniverseSafe(UniverseDefault origin, AtomicReference<Throwable> throwable)	Ctor.

Method Summary

Modifier and Type	Method	Description
void	bind(int parent, int child, String att)	Binds child to parent.
int	copy(int vertex)	Copies the eo object.
byte[]	dataize(int vertex)	Dataizes the eo object by vertex and return byte array.
int	find(String name)	Finds vertex of eo object by its location.
void	put(int vertex, byte[] bytes)	Puts data to eo object by vertex.

Methods inherited from class java.lang.Object

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

Constructor Detail

UniverseSafe

public UniverseSafe(UniverseDefault origin,
                    AtomicReference<Throwable> throwable)

Ctor.

Parameters:

origin - Origin.

throwable - A cell to keep throwable.

Method Detail

find

public int find(String name)

Description copied from interface: Universe

Finds vertex of eo object by its location.

Specified by:

find in interface Universe

Parameters:

name - Relative location of the object to find like "^.^.some-obj".

Returns:

Vertex of the object to find.

put

public void put(int vertex,
                byte[] bytes)

Description copied from interface: Universe

Puts data to eo object by vertex.

Specified by:

put in interface Universe

Parameters:

vertex - Vertex off object.

bytes - Data to put.

bind

public void bind(int parent,
                 int child,
                 String att)

Description copied from interface: Universe

Binds child to parent.

Specified by:

bind in interface Universe

Parameters:

parent - Vertex of the parent eo object.

child - Vertex of the child eo object.

att - Name of attribute.

copy

public int copy(int vertex)

Description copied from interface: Universe

Copies the eo object.

Specified by:

copy in interface Universe

Parameters:

vertex - Vertex of object to copy.

Returns:

Vertex of the copy.

dataize

public byte[] dataize(int vertex)

Description copied from interface: Universe

Dataizes the eo object by vertex and return byte array.

Specified by:

dataize in interface Universe

Parameters:

vertex - Vertex of eo-object.

Returns:

Raw data.