mds.data.TREE Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of mdsplus-api Show documentation
Show all versions of mdsplus-api Show documentation
MDSplus interface (via lib or mdsip).
package mds.data;
import java.util.*;
import mds.*;
import mds.Mds.Request;
import mds.Shr.StringStatus;
import mds.TreeShr.*;
import mds.data.descriptor.Descriptor;
import mds.data.descriptor.Descriptor_A;
import mds.data.descriptor_a.Int32Array;
import mds.data.descriptor_a.NidArray;
import mds.data.descriptor_apd.List;
import mds.data.descriptor_r.Signal;
import mds.data.descriptor_s.*;
import mds.data.descriptor_s.NODE.Flags;
import mds.mdsip.MdsIp;
public final class TREE implements ContextEventListener, CTX, AutoCloseable
{
@SuppressWarnings("hiding")
public enum MODE
{
CLOSED, READONLY, NORMAL, EDITABLE, NEW;
}
public final static class NodeInfo
{
public static final String members = "IF_ERROR(GETNCI(GETNCI(_n,'MEMBER_NIDS'),'NID_NUMBER'),[])";
public static final String children = "IF_ERROR(GETNCI(GETNCI(_n,'CHILDREN_NIDS'),'NID_NUMBER'),[])";
public static final String conglom_nids = "(IF(GETNCI(_n,'CONGLOMERATE_ELT')>0){GETNCI(GETNCI(_n,'CONGLOMERATE_NIDS'),'NID_NUMBER');}ELSE{[];};)";
public static final String descendants = String.format("[%s,%s]", NodeInfo.children, NodeInfo.members);
public static final String def_nodeinfo = "PUBLIC FUN NODEINFO(IN _n){RETURN(List(*,GETNCI(_n,'USAGE'),_n,GETNCI(_n,'GET_FLAGS'),GETNCI(_n,'STATUS'),GETNCI(_n,'NUMBER_OF_CHILDREN')+GETNCI(_n,'NUMBER_OF_MEMBERS'),TRIM(GETNCI(_n,'NODE_NAME')),GETNCI(_n,'MINPATH'),GETNCI(_n,'PATH'),GETNCI(_n,'FULLPATH')));}";
public static final String def_nodeinfos = "PUBLIC FUN NODEINFOS(IN _m){_l=LIST();FOR(_i=0;_i node, final Mds mds, final CTX ctx)
throws MdsException
{
mds.defineFunctions(NodeInfo.def_nodeinfo, NodeInfo.def_nodeinfos);
final Request request = new Request<>(List.class,
"_n=GETNCI($,'NID_NUMBER');NODEINFOS(" + NodeInfo.conglom_nids + ")", node);
final List list = mds.getDescriptor(ctx, request);
final NodeInfo[] infos = new NodeInfo[list.getLength()];
for (int i = 0; i < infos.length; i++)
infos[i] = new NodeInfo((List) list.get(i));
return infos;
}
@SuppressWarnings("resource")
public static final NodeInfo getNodeInfo(final NODE node) throws MdsException
{
final TREE tree = node.getTree();
return NodeInfo.getNodeInfo(node, tree.getMds(), tree);
}
public static final NodeInfo getNodeInfo(final NODE node, final Mds mds, final CTX ctx) throws MdsException
{
mds.defineFunctions(NodeInfo.def_nodeinfo);
return new NodeInfo(
mds.getDescriptor(ctx, new Request<>(List.class, "NODEINFO(GETNCI($,'NID_NUMBER'))", node)));
}
public static final NodeInfo[] getNodeInfos(final NidArray nodes, final Mds mds, final CTX ctx)
throws MdsException
{
mds.defineFunctions(NodeInfo.def_nodeinfo, NodeInfo.def_nodeinfos);
final Request request = new Request<>(List.class, "NODEINFOS(GETNCI($,'NID_NUMBER'))", nodes);
final List list = mds.getDescriptor(ctx, request);
final NodeInfo[] infos = new NodeInfo[list.getLength()];
for (int i = 0; i < infos.length; i++)
infos[i] = new NodeInfo((List) list.get(i));
return infos;
}
@SuppressWarnings("resource")
public static final NodeInfo[][] getNodeInfos(final NODE node) throws MdsException
{
final TREE tree = node.getTree();
return NodeInfo.getNodeInfos(node, tree.getMds(), tree);
}
public static final NodeInfo[][] getNodeInfos(final NODE node, final Mds mds, final CTX ctx)
throws MdsException
{
mds.defineFunctions(NodeInfo.def_nodeinfo, NodeInfo.def_nodeinfos);
final Request request = new Request<>(List.class, "_n=GETNCI($,'NID_NUMBER');List(*,NODEINFOS("
+ NodeInfo.children + "),NODEINFOS(" + NodeInfo.members + "))", node);
final List list2 = mds.getDescriptor(ctx, request);
final NodeInfo[][] infos = new NodeInfo[2][];
for (int t = 0; t < infos.length; t++)
{
final List list = (List) list2.get(t);
infos[t] = new NodeInfo[list.getLength()];
for (int i = 0; i < infos[t].length; i++)
infos[t][i] = new NodeInfo((List) list.get(i));
}
return infos;
}
public final byte usage;
public final int nid_number, get_flags, status, num_descendants;
public final String node_name, minpath, path, fullpath;
private NodeInfo(final Descriptor[] dscs)
{
this.usage = dscs[0].toByte();
this.nid_number = dscs[1].toInt();
this.get_flags = dscs[2].toInt();
this.status = dscs[3].toInt();
this.num_descendants = dscs[4].toInt();
this.node_name = dscs[5].toString().trim();
this.minpath = dscs[6].toString();
this.path = dscs[7].toString();
this.fullpath = dscs[8].toString();
}
private NodeInfo(final List list)
{
this(list.toArray());
}
}
public final static class RecordInfo
{
private static final String def_recordinfo = "PUBLIC FUN RECORDINFO(IN _n){RETURN(LIST(*,GETNCI(_n,'DTYPE'),GETNCI(_n,'CLASS'),_n,GETNCI(_n,'STATUS'),GETNCI(_n,'GET_FLAGS'),GETNCI(_n,'LENGTH'),GETNCI(_n,'RLENGTH'),(_a=-1;TreeShr->TreeGetNumSegments(val(_n),ref(_a));_a;),DATE_TIME(GETNCI(_n,'TIME_INSERTED'))));}";
private static final String request = "_n=GETNCI($,'NID_NUMBER');RECORDINFO(_n)";
public static final Request getRequest(final NODE node)
{
return new Request<>(List.class, RecordInfo.request, node);
}
public final byte dtype, dclass;
public final int nid_number, status, get_flags, length, rlength, num_segments;
public final String time_inserted;
private RecordInfo(final NODE node, final Mds mds, final Pointer ctx) throws MdsException
{
mds.defineFunctions(RecordInfo.def_recordinfo);
final List list = mds.getDescriptor(ctx, RecordInfo.getRequest(node));
this.dtype = list.get(0).toByte();
this.dclass = list.get(1).toByte();
this.nid_number = list.get(2).toInt();
this.status = list.get(3).toInt();
this.get_flags = list.get(4).toInt();
this.length = list.get(5).toInt();
this.rlength = list.get(6).toInt();
this.num_segments = list.get(7).toInt();
this.time_inserted = list.get(8).toString();
}
@Override
public final String toString()
{
final StringBuilder sb = new StringBuilder(255).append('(');
sb.append("dtype:").append(this.dtype).append(", ");
sb.append("dclass:").append(this.dclass).append(", ");
sb.append("nid_number:").append(this.nid_number).append(", ");
sb.append("status:").append(this.status).append(", ");
sb.append("get_flags:").append(this.get_flags).append(", ");
sb.append("length:").append(this.length).append(", ");
sb.append("rlength:").append(this.rlength).append(", ");
sb.append("num_segments:").append(this.num_segments).append(", ");
sb.append("time_inserted:").append(this.time_inserted).append(')');
return sb.toString();
}
}
public static final class TagList extends HashMap
{
private static final long serialVersionUID = 1L;
private final String root;
public TagList(final int capacity, final String expt)
{
super(capacity);
this.root = new StringBuilder(expt.length() + 3).append("\\").append(expt).append("::").toString();
}
@Override
public final String toString()
{
final StringBuilder str = new StringBuilder(this.size() * 64);
for (final Map.Entry entry : this.entrySet())
str.append(entry.getKey().replace(this.root, "\\")).append(" => ").append(entry.getValue())
.append("\n");
return str.toString();
}
}
public static final MODE EDITABLE = MODE.EDITABLE;
public static final MODE NEW = MODE.NEW;
public static final MODE NORMAL = MODE.NORMAL;
public static final MODE READONLY = MODE.READONLY;
public static final MODE CLOSED = MODE.CLOSED;
private static TREE active = null;
public static final String NCI_BROTHER = "BROTHER";
public static final String NCI_CHILD = "CHILD";
public static final String NCI_CHILDREN_NIDS = "CHILDREN_NIDS";
public static final String NCI_CLASS = "CLASS";
public static final String NCI_CLASS_STR = "CLASS_STR";
public static final String NCI_CONGLOMERATE_ELT = "CONGLOMERATE_ELT";
public static final String NCI_CONGLOMERATE_NIDS = "CONGLOMERATE_NIDS";
public static final String NCI_DATA_IN_NCI = "DATA_IN_NCI";
public static final String NCI_DEPTH = "DEPTH";
public static final String NCI_DTYPE = "DTYPE";
public static final String NCI_DTYPE_STR = "DTYPE_STR";
public static final String NCI_ERROR_ON_PUT = "ERROR_ON_PUT";
public static final String NCI_FULLPATH = "FULLPATH";
public static final String NCI_GET_FLAGS = "GET_FLAGS";
public static final String NCI_IS_CHILD = "IS_CHILD";
public static final String NCI_IS_MEMBER = "IS_MEMBER";
public static final String NCI_LENGTH = "LENGTH";
public static final String NCI_MEMBER = "MEMBER";
public static final String NCI_MEMBER_NIDS = "MEMBER_NIDS";
public static final String NCI_MINPATH = "MINPATH";
public static final String NCI_NID_NUMBER = "NID_NUMBER";
public static final String NCI_NODE_NAME = "NODE_NAME";
public static final String NCI_NUMBER_OF_CHILDREN = "NUMBER_OF_CHILDREN";
public static final String NCI_NUMBER_OF_ELTS = "NUMBER_OF_ELTS";
public static final String NCI_NUMBER_OF_MEMBERS = "NUMBER_OF_MEMBERS";
public static final String NCI_ORIGINAL_PART_NAME = "ORIGINAL_PART_NAME";
public static final String NCI_OWNER_ID = "OWNER_ID";
public static final String NCI_PARENT = "PARENT";
public static final String NCI_PARENT_RELATIONSHIP = "PARENT_RELATIONSHIP";
public static final String NCI_PARENT_TREE = "PARENT_TREE";
public static final String NCI_PATH = "PATH";
public static final String NCI_RECORD = "RECORD";
public static final String NCI_RFA = "RFA";
public static final String NCI_RLENGTH = "RLENGTH";
public static final String NCI_STATUS = "STATUS";
public static final String NCI_TIME_INSERTED = "TIME_INSERTED";
public static final String NCI_TIME_INSERTED_STR = "TIME_INSERTED_STR";
public static final String NCI_USAGE = "USAGE";
public static final String NCI_USAGE_STR = "USAGE_STR";
public static final String NCI_VERSION = "VERSION";
public static final String NCI_STATE = "STATE";
public static final TREE getActiveTree()
{
return TREE.active;
}
public static final NodeInfo[] getDeviceNodeInfos(final Descriptor nodes, final Mds mds, final CTX ctx)
throws MdsException
{
mds.defineFunctions(NodeInfo.def_nodeinfo, NodeInfo.def_nodeinfos);
final Request request = new Request<>(List.class, "GETNCI($,'NID_NUMBER')", nodes);
final List list = mds.getDescriptor(ctx, request);
final NodeInfo[] infos = new NodeInfo[list.getLength()];
for (int i = 0; i < infos.length; i++)
infos[i] = new NodeInfo((List) list.get(i));
return infos;
}
public static final > Request getNciRequest(final Class cls, final NODE node,
final String name)
{
if (TREE.NCI_TIME_INSERTED_STR.equals(name))
return new Request<>(cls, "DATE_TIME(GETNCI($,'TIME_INSERTED'))", node);
return new Request<>(cls, "GETNCI($,$)", node, Descriptor.valueOf(name));
}
private Pointer oldctx = null;
private Nid def_nid;
public final Pointer ctx = Pointer.NULL();
public final int shot;
private final Mds mds;
public final String expt;
public final String exptlist;
private MODE mode;
public final MdsApi api;
public boolean opened = false;
private boolean ready;
public TREE(final Mds mds, final String expt, int shot)
{
this.mds = mds;
this.ready = mds.isReady() == null;
this.api = mds.getAPI();
this.exptlist = expt.toUpperCase();
this.expt = this.exptlist.split(",", 2)[0];
try
{
if (shot == 0)
shot = this.getCurrentShot();
}
catch (final MdsException e)
{
/**/}
this.shot = shot;
this.mode = TREE.CLOSED;
this.def_nid = this.getTop();
}
public TREE(final Mds mds, final String expt, final int shot, final MODE mode) throws MdsException
{
this(mds, expt, shot);
if (mode != TREE.CLOSED)
{
this.mode = mode;
this._open();
}
}
private final Descriptor _getNci(final int nid, final String name) throws MdsException
{
if (TREE.NCI_TIME_INSERTED_STR.equals(name))
return this.mds.getDescriptor(this.ctx, new StringBuilder(48).append("DATE_TIME(GETNCI(").append(nid)
.append(",'TIME_INSERTED'))").toString());
return this.mds.getDescriptor(this.ctx,
new StringBuilder(24).append("GETNCI(").append(nid).append(",$)").toString(), Descriptor.valueOf(name));
}
private final TREE _open() throws MdsException
{
final int status;
switch (this.mode)
{
case NEW:
this.mode = TREE.EDITABLE;
status = this.api.treeOpenNew(this.ctx, this.expt, this.shot);
break;
case EDITABLE:
status = this.api.treeOpenEdit(this.ctx, this.expt, this.shot);
break;
default:
this.mode = TREE.READONLY;
//$FALL-THROUGH$
case READONLY:
case NORMAL:
status = this.api.treeOpen(this.ctx, this.exptlist, this.shot, this.is_readonly());
}
MdsException.handleStatus(status);
this.updateListener(true);
return this;
}
public final Nid addConglom(final NODE node, final String name, final String model) throws MdsException
{
synchronized (this.mds)
{
final NODE def = this.getDefaultNid();
node.setDefault();
final Nid nid = this.addConglom(name, model);
def.setDefault();
return nid;
}
}
public final Nid addConglom(final String path, final String model) throws MdsException
{
return new Nid(this.setActive().api.treeAddConglom(this.ctx, path, model).getData(), this);
}
public final Nid addNode(final String path, final byte usage) throws MdsException
{
synchronized (this.mds)
{
final IntegerStatus res = this.setActive().api.treeAddNode(this.ctx, path, usage);
final Nid nid = new Nid(res.getData(), this);
if (usage == NODE.USAGE_SUBTREE)
nid.setSubtree();
return nid;
}
}
public final TREE addTag(final int nid, final String tag) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeAddTag(this.ctx, nid, tag));
return this;
}
public final TREE clearFlags(final int nid, final int flags) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeSetNciItm(this.ctx, nid, false, flags & 0x7FFFFFFC));
return this;
}
public final TREE clearTags(final int nid) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeRemoveNodesTags(this.ctx, nid));
return this;
}
@Override
public final void close()
{
try
{
if (this.is_editable())
{
this.api.treeQuitTree(this.ctx, null, 0);
this.api.treeFreeDbid(this.ctx);
}
else if (this.ctx != null && !this.ctx.isNull())
{
this.api.treeClose(this.ctx, null, 0);
this.api.treeFreeDbid(this.ctx);
}
}
catch (final MdsException e)
{
// ignore
}
this.updateListener(false);
}
public final TREE createTreeFiles(final int newshot) throws MdsException
{
MdsException.handleStatus(this.api.treeCreateTreeFiles(null, this.expt, newshot, this.shot));
return new TREE(this.mds, this.expt, newshot);
}
public final TREE deleteNodeExecute() throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeDeleteNodeExecute(this.ctx));
return this;
}
public final Nid[] deleteNodeGetNids() throws MdsException
{
synchronized (this.mds)
{
final ArrayList nids = new ArrayList<>(256);
int last = 0;
for (;;)
{
final IntegerStatus res = this.setActive().api.treeDeleteNodeGetNid(this.ctx, last);
if (res.status == MdsException.TreeNMN)
break;
nids.add(new Nid(last = res.getData(), this));
}
return nids.toArray(new Nid[0]);
}
}
public final int deleteNodeInitialize(final int nid) throws MdsException
{
return this.setActive().api.treeDeleteNodeInitialize(this.ctx, nid).getData();
}
public final TREE doAction(final int nid) throws MdsException
{
this.getNode(nid).doAsTask();
return this;
}
public final Descriptor doDeviceMethod(final int nid, final String method, final Descriptor... args)
throws MdsException
{
return this.api.treeDoMethod(this.ctx, nid, method, args).getData();
}
@Override
protected final void finalize() throws MdsException
{
if (this.is_open())
System.err.println(this + " was still open.");
this.quitTree();
}
public Nid[] findNodesWild(final byte usage) throws MdsException
{
return this.findNodesWild("***", usage);
}
public final Nid[] findNodesWild(final String searchstr, final byte usage) throws MdsException
{
try
{
return Nid.getArrayOfNids(this.mds.getIntegerArray(this.ctx, "GETNCI($,'NID_NUMBER',$)",
Descriptor.valueOf(searchstr), new StringDsc(NODE.getUsageStr(usage))), this);
}
catch (final MdsException e)
{
if (e.getStatus() == MdsException.TreeNNF)
return new Nid[0];
throw e;
}
}
public final Nid[] findNodesWildLL(final int usage) throws MdsException
{
return this.findNodesWildLL("***", 1 << usage);
}
public final Nid[] findNodesWildLL(final String searchstr, final int usage_mask) throws MdsException
{
final ArrayList nids = new ArrayList<>(1024);
synchronized (this.mds)
{
this.holdDbid();
try
{
NodeRefStatus ref = NodeRefStatus.init;
while ((ref = this.api.treeFindNodeWild(null, searchstr, usage_mask, ref)).ok())
nids.add(new Nid(ref.data, this));
}
finally
{
this.releaseDbid();
}
}
return nids.toArray(new Nid[0]);
}
public final TagRef findNodeTags(final int nid, final TagRef ref) throws MdsException
{
return this.setActive().api.treeFindNodeTags(this.ctx, nid, ref);
}
public final NodeRefStatus findNodeWild(final String searchstr, final int usage_mask, final NodeRefStatus ref)
throws MdsException
{
return this.setActive().api.treeFindNodeWild(this.ctx, searchstr, usage_mask, ref);
}
public final TagList findTags() throws MdsException
{
final String root = new StringBuilder(this.expt.length() + 3).append("\\").append(this.expt).append("::")
.toString();
final Descriptor dsc = this.setActive().mds.getDescriptor(this.ctx,
"__l=List();__n=-1;__c=0;while(0 pair : (List) dsc)
taglist.put(((List) pair).get(0).toString().replace(root, "\\"),
new Nid(((List) pair).get(1).toInt(), this));
return taglist;
}
public final String[][] findTagsPath() throws MdsException
{
final String root = new StringBuilder(this.expt.length() + 3).append("\\").append(this.expt).append("::")
.toString();
final Descriptor dsc = this.setActive().mds.getDescriptor(this.ctx,
"__l=List();__n=-1;__c=0;while(0= max)
this.api.treeFindTagEnd(null, tag);
this.releaseDbid();
}
}
return taglist;
}
public final TagRefStatus findTagWild(final String searchstr, final TagRefStatus ref) throws MdsException
{
return this.setActive().api.treeFindTagWild(this.ctx, searchstr, ref);
}
public final int getCurrentShot() throws MdsException
{
return this.setActive().api.treeGetCurrentShotId(null, this.expt);
}
@Override
public final Pointer getDbid()
{
return this.ctx;
}
public final int getDefault() throws MdsException
{
return this.getDefaultNid().getNidNumber();
}
public final Nid getDefaultC()
{
return this.def_nid;
}
public final Nid getDefaultNid() throws MdsException
{
return this.def_nid = new Nid(this.setActive().api.treeGetDefaultNid(this.ctx).getData(), this);
}
public final String getFileName() throws MdsException
{
return this.getFileName(this.expt);
}
public final String getFileName(final String subtree) throws MdsException
{
final StringStatus ans = this.setActive().api.treeFileName(this.ctx, subtree, this.shot);
if (ans.status == MdsException.TreeFOPENR)
throw new MdsException(ans.status);
MdsException.handleStatus(ans.status);
return ans.data;
}
@Override
public final Mds getMds()
{
return this.mds;
}
public final MODE getMode()
{
return this.mode;
}
public final Descriptor getNci(final int nid, final String name) throws MdsException
{
return this.setActive()._getNci(nid, name);
}
public final Descriptor getNci(final NODE node, final String name) throws MdsException
{
if (node instanceof Nid)
return this.setActive()._getNci(node.getNidNumber(), name);
return this.setActive().mds.getDescriptor(this.ctx, TREE.getNciRequest(Descriptor.class, node, name));
}
public final Nid getNciBrother(final int nid) throws MdsException
{
return (Nid) this.getNci(nid, TREE.NCI_BROTHER);
}
public final Nid getNciChild(final int nid) throws MdsException
{
return (Nid) this.getNci(nid, TREE.NCI_CHILD);
}
public final NidArray getNciChildrenNids(final int nid) throws MdsException
{
final StringBuilder cmd = new StringBuilder(128).append("IF_ERROR(GETNCI(GETNCI(").append(nid)
.append(",'CHILDREN_NIDS'),'NID_NUMBER'),[])");
return new NidArray(this, this.setActive().mds.getDescriptor(this.ctx, cmd.toString(), Int32Array.class));
}
public final NidArray getNciChildrenNids(final NODE node) throws MdsException
{
return new NidArray(this, this.setActive().mds.getDescriptor(this.ctx,
"IF_ERROR(GETNCI(GETNCI($,'CHILDREN_NIDS'),'NID_NUMBER'),LONG([]))", Int32Array.class, node));
}
public final byte getNciClass(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_CLASS).toByte();
}
public final String getNciClassStr(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_CLASS_STR).toString();
}
public final short getNciConglomerateElt(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_CONGLOMERATE_ELT).toShort();
}
public final NidArray getNciConglomerateNids(final int nid) throws MdsException
{
return (NidArray) this.getNci(nid, TREE.NCI_CONGLOMERATE_NIDS);
}
public final int getNciDataInNci(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_DATA_IN_NCI).toInt();
}
public final int getNciDepth(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_DEPTH).toInt();
}
public final byte getNciDType(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_DTYPE).toByte();
}
public final String getNciDTypeStr(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_DTYPE_STR).toString();
}
public final int getNciErrorOnPut(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_ERROR_ON_PUT).toInt();
}
public final int getNciFlags(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_GET_FLAGS).toInt();
}
public final String getNciFullPath(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_FULLPATH).toString();
}
public final boolean getNciIsChild(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_IS_CHILD).toByte() != 0;
}
public final boolean getNciIsMember(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_IS_MEMBER).toByte() != 0;
}
public final int getNciLength(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_LENGTH).toInt();
}
public final Nid getNciMember(final int nid) throws MdsException
{
return (Nid) this.getNci(nid, TREE.NCI_MEMBER);
}
public final NidArray getNciMemberNids(final int nid) throws MdsException
{
final StringBuilder cmd = new StringBuilder(128).append("IF_ERROR(GETNCI(GETNCI(").append(nid)
.append(",'MEMBER_NIDS'),'NID_NUMBER'),[])");
return new NidArray(this, this.setActive().mds.getDescriptor(this.ctx, cmd.toString(), Int32Array.class));
}
public final NidArray getNciMemberNids(final NODE node) throws MdsException
{
return new NidArray(this, this.setActive().mds.getDescriptor(this.ctx,
"IF_ERROR(GETNCI(GETNCI($,'MEMBER_NIDS'),'NID_NUMBER'),[])", Int32Array.class, node));
}
public final String getNciMinPath(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_MINPATH).toString();
}
public final int getNciNidNumber(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_NID_NUMBER).toInt();
}
public final String getNciNodeName(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_NODE_NAME).toString().trim();
}
public final int getNciNumberOfChildren(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_NUMBER_OF_CHILDREN).toInt();
}
public final int getNciNumberOfElts(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_NUMBER_OF_ELTS).toInt();
}
public final int getNciNumberOfMembers(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_NUMBER_OF_MEMBERS).toInt();
}
public final String getNciOriginalPartName(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_ORIGINAL_PART_NAME).toString().trim();
}
public final int getNciOwnerId(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_OWNER_ID).toInt();
}
public final Nid getNciParent(final int nid) throws MdsException
{
return (Nid) this.getNci(nid, TREE.NCI_PARENT);
}
public final int getNciParentRelationship(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_PARENT_RELATIONSHIP).toInt();
}
public final String getNciParentTree(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_PARENT_TREE).toString();
}
public final String getNciPath(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_PATH).toString();
}
public final Descriptor getNciRecord(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_RECORD);
}
public final long getNciRfa(final int nid) throws MdsException
{
return this.getNci(nid, "RFA").toLong();
}
public final int getNciRLength(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_RLENGTH).toInt();
}
public final int getNciState(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_STATE).toInt();
}
public final int getNciStatus(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_STATUS).toInt();
}
public final long getNciTimeInserted(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_TIME_INSERTED).toLong();
}
public final long getNciTimeInserted(final NODE node) throws MdsException
{
return this.getNci(node, TREE.NCI_TIME_INSERTED).toLong();
}
public final String getNciTimeInsertedStr(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_TIME_INSERTED_STR).toString();
}
public final String getNciTimeInsertedStr(final NODE node) throws MdsException
{
return this.getNci(node, TREE.NCI_TIME_INSERTED_STR).toString();
}
public final byte getNciUsage(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_USAGE).toByte();
}
public final String getNciUsageStr(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_USAGE_STR).toString();
}
public final int getNciVersion(final int nid) throws MdsException
{
return this.getNci(nid, TREE.NCI_VERSION).toInt();
}
public final Nid getNode(final int nid)
{
return new Nid(nid, this);
}
public final Nid getNode(final String path) throws MdsException
{
return new Path(path, this).toNid();
}
public final NodeInfo getNodeInfo(final NODE node) throws MdsException
{
return NodeInfo.getNodeInfo(node, this.mds, this.ctx);
}
public final NodeInfo[] getNodeInfos(final Nid[] nids) throws MdsException
{
final NodeInfo[] infos = new NodeInfo[nids.length];
if (nids.length == 0)
return infos;
final List list = this.mds.getDescriptor(this.ctx, "nodeinfos($)", List.class, new Int32Array(nids));
for (int i = 0; i < list.getLength(); i++)
infos[i] = new NodeInfo((List) list.get(i));
return infos;
}
public final int getNumSegments(final int nid) throws MdsException
{
return this.setActive().api.treeGetNumSegments(this.ctx, nid).getData();
}
public final Descriptor getRecord(final int nid) throws MdsException
{
return this.setActive().api.treeGetRecord(this.ctx, nid).getData();
}
public final RecordInfo getRecordInfo(final NODE node) throws MdsException
{
return new RecordInfo(node, this.mds, this.ctx);
}
public final Signal getSegment(final int nid, final int idx) throws MdsException
{
final Signal sig = this.setActive().api.treeGetSegment(this.ctx, nid, idx);
try
{
final Descriptor scale = this.api.treeGetSegmentScale(this.ctx, nid);
if (Descriptor.isMissing(scale))
return sig;
return new Signal(scale, sig.getValue(), sig.getDimension());
}
catch (final MdsException e)
{
return sig;
}
}
public Descriptor_A getSegmentData(final int nid, final int idx) throws MdsException
{
return this.setActive().api.treeGetSegmentData(this.ctx, nid, idx);
}
public Descriptor getSegmentDim(final int nid, final int idx) throws MdsException
{
return this.setActive().api.treeGetSegmentDim(this.ctx, nid, idx);
}
public final SegmentInfo getSegmentInfo(final int nid, final int idx) throws MdsException
{
return this.setActive().api.treeGetSegmentInfo(this.ctx, nid, idx);
}
public final List getSegmentLimits(final int nid, final int idx) throws MdsException
{
final DescriptorStatus dscs = this.setActive().api.treeGetSegmentLimits(this.ctx, nid, idx);
return (List) dscs.getData();
}
public final Descriptor getSegmentScale(final int nid) throws MdsException
{
return this.setActive().api.treeGetSegmentScale(this.ctx, nid);
}
public List getSegmentTimes(final int nid) throws MdsException
{
return (List) this.setActive().api.treeGetSegmentTimesXd(this.ctx, nid).getData();
}
public final String[] getTags(final int nid) throws MdsException
{
final StringBuilder cmd = new StringBuilder(170).append("_a=0Q;_i=0;_l=LIST();");
cmd.append("_x=REPEAT(' ',64);WHILE((_i<1024)&&(TreeShr->TreeFindNodeTagsDsc(val(");
cmd.append(nid).append("),ref(_a),descr(_x))&1))(_i++;_l=List(_l,TRIM(_x)););_l");
final List list = this.mds.getDescriptor(this.ctx, cmd.toString(), List.class);
return list.toStringArray();
}
public final String[] getTagsLL(final int nid) throws MdsException
{
final ArrayList tags = new ArrayList<>(255);
synchronized (this.mds)
{
this.holdDbid();
try
{
TagRef tag = TagRef.init;
while (tags.size() < 255 && (tag = this.api.treeFindNodeTags(this.ctx, nid, tag)).ok())
tags.add(tag.data);
}
finally
{
this.releaseDbid();
}
}
return tags.toArray(new String[0]);
}
public final List getTimeContext() throws MdsException
{
return (List) this.setActive().api.treeGetTimeContext(this.ctx).getData();
}
public final Nid getTop()
{
return new Nid(0, this);
}
public final Descriptor getXNci(final int nid, final String name) throws MdsException
{
return this.setActive().api.treeGetXNci(this.ctx, nid, name).getData();
}
@Override
public void handleContextEvent(final Mds source, final String info, final boolean ok)
{
if (!ok)
this.ctx.setAddress(0);
this.ready = ok;
}
public final void holdDbid() throws MdsException
{
if (this.oldctx != null)
return;
this.oldctx = this.api.treeSwitchDbid(null, this.ctx);
}
public final boolean is_editable()
{
return this.mode == TREE.EDITABLE;
}
public final boolean is_nid_reference(final int nid) throws MdsException
{
return new Flags(this.getNciFlags(nid)).isNidReference();
}
public final boolean is_open()
{
return (this.ctx != null && !this.ctx.isNull() && this.opened);
}
public final boolean is_path_reference(final int nid) throws MdsException
{
return new Flags(this.getNciFlags(nid)).isPathReference();
}
public final boolean is_readonly()
{
return this.mode == TREE.READONLY;
}
public final boolean is_segmented(final int nid) throws MdsException
{
synchronized (this.mds)
{
if (new Flags(this.getNciFlags(nid)).isSegmented())
return true; // cannot be sure due to issue in winter 2015/2016
return this.getNumSegments(nid) > 0;
}
}
public final TREE makeSegment(final int nid, final Descriptor_A dimension, final Descriptor_A values)
throws MdsException
{
return this.makeSegment(nid, dimension.getScalar(0), dimension.getScalar(dimension.getLength() - 1), dimension,
values, -1, dimension.getLength());
}
public final TREE makeSegment(final int nid, final Descriptor start, final Descriptor end,
final Descriptor dimension, final Descriptor_A values, final int idx, final int rows_filled)
throws MdsException
{
this.api.treeMakeSegment(this.ctx, nid, start, end, dimension, values, idx, rows_filled);
return this;
}
public final TREE open() throws MdsException
{
return this.setActive()._open();
}
public final TREE open(final MODE in_mode) throws MdsException
{
this.mode = in_mode;
return this.open();
}
public final TREE putRecord(final int nid, final Descriptor data) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treePutRecord(this.ctx, nid, data));
return this;
}
public final TREE putRow(final int nid, final long time, final Descriptor_A data) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treePutRow(this.ctx, nid, 1 << 20, time, data));
return this;
}
public final TREE putSegment(final int nid, final int idx, final Descriptor_A data) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treePutSegment(this.ctx, nid, idx, data));
return this;
}
public final TREE putTimestampedSegment(final int nid, final long timestamp, final Descriptor_A data)
throws MdsException
{
MdsException.handleStatus(this.setActive().api.treePutTimestampedSegment(this.ctx, nid, timestamp, data));
return this;
}
public final TREE quitTree() throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeQuitTree(this.ctx, this.expt, this.shot));
this.updateListener(false);
return this;
}
public final void releaseDbid() throws MdsException
{
if (this.oldctx == null)
return;
this.api.treeSwitchDbid(null, this.oldctx);
this.oldctx = null;
}
public final TREE setActive() throws MdsException
{
if (this.opened && !this.is_open() && this.ready)
{
this._open();
this.def_nid.setDefault();
}
return TREE.active = this;
}
public final TREE setCurrentShot() throws MdsException
{
return this.setCurrentShot(this.shot);
}
public final TREE setCurrentShot(final int shot) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeSetCurrentShotId(null, this.expt, shot));
return this;
}
public final void setDefault(final int nid) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeSetDefaultNid(this.ctx, nid));
this.def_nid = new Nid(nid, this);
}
public final void setDefault(final String def_node) throws MdsException
{
final Nid newdef = this.getNode(def_node);
MdsException.handleStatus(this.setActive().api.treeSetDefaultNid(this.ctx, newdef.getNidNumber()));
this.def_nid = newdef;
}
public final TREE setFlags(final int nid, final int flags) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeSetNciItm(this.ctx, nid, true, flags & 0x7FFFFFFC));
return this;
}
public final TREE setNoSubtree(final int nid) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeSetNoSubtree(this.ctx, nid));
return this;
}
public final TREE setPath(final int nid, final String path) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeRenameNode(this.ctx, nid, path));
return this;
}
public final int setSegmentScale(final int nid, final Descriptor scale) throws MdsException
{
return this.setActive().api.treeSetSegmentScale(this.ctx, nid, scale);
}
public final TREE setSubtree(final int nid) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeSetSubtree(this.ctx, nid));
return this;
}
public final TREE setTags(final int nid, final String... tags) throws MdsException
{
synchronized (this.mds)
{
this.clearTags(nid);
if (tags == null)
return this;
for (int i = tags.length; i-- > 0;)
this.addTag(nid, tags[i]);
}
return this;
}
public final void setTimeContext(final Number start, final Number end, final Number delta) throws MdsException
{
this.setActive().api.treeSetTimeContext(this.ctx, start, end, delta);
}
public final void setVersioning(final boolean model, final boolean pulse) throws MdsException
{
MdsException
.handleStatus(this.setActive().api.treeSetDbiItm(this, TreeShr.DBI_VERSIONS_IN_MODEL, model ? 1 : 0));
MdsException
.handleStatus(this.setActive().api.treeSetDbiItm(this, TreeShr.DBI_VERSIONS_IN_PULSE, pulse ? 1 : 0));
}
@Override
public final String toString()
{
final StringBuilder sb = new StringBuilder("Tree(\"").append(this.expt).append("\", ");
if (this.shot == -1)
sb.append("model");
else
sb.append(this.shot);
if (this.mode == TREE.EDITABLE)
sb.append(", edit");
else if (this.mode == TREE.READONLY)
sb.append(", readonly");
return sb.append(')').toString();
}
public final TREE turnOff(final int nid) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeTurnOff(this.ctx, nid));
return this;
}
public final TREE turnOn(final int nid) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeTurnOn(this.ctx, nid));
return this;
}
private final void updateListener(final boolean opened_in)
{
this.opened = opened_in;
if (this.opened)
this.mds.addContextEventListener(this);
else
this.mds.removeContextEventListener(this);
}
public final TREE updateSegment(final int nid, final Descriptor start, final Descriptor end,
final Descriptor dim, final int idx) throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeUpdateSegment(this.ctx, nid, start, end, dim, idx));
return this;
}
public final TREE verify() throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeVerify(this.ctx));
return this;
}
@SuppressWarnings("resource")
public final TREE withPrivateConnection()
{
if (!(this.mds instanceof MdsIp))
return null;
return new TREE(new MdsIp(((MdsIp) this.mds).getProvider()), this.expt, this.shot);
}
public final TREE writeTree() throws MdsException
{
MdsException.handleStatus(this.setActive().api.treeWriteTree(this.ctx, this.expt, this.shot));
return this;
}
}