Package us.kbase.workspace

Class ObjectSpecification

  • @Generated("com.googlecode.jsonschema2pojo")
public class ObjectSpecification
extends java.lang.Object

    Original spec-file type: ObjectSpecification

     An Object Specification (OS). Inherits from ObjectIdentity (OI).
 Specifies which object, and which parts of that object, to retrieve
 from the Workspace Service.
 The fields wsid, workspace, objid, name, and ver are identical to
 the OI fields.
 The ref field's behavior is extended from OI. It maintains its
 previous behavior, but now also can act as a reference string. See
 reference following below for more information.
 REFERENCE FOLLOWING:
 Reference following guarantees that a user that has access to an
 object can always see a) objects that are referenced inside the object
 and b) objects that are referenced in the object's provenance. This
 ensures that the user has visibility into the entire provenance of the
 object and the object's object dependencies (e.g. references).
 The user must have at least read access to the object specified in this
 SO, but need not have access to any further objects in the reference
 chain, and those objects may be deleted.
 Optional reference following fields:
 Note that only one of the following fields may be specified.
 ref_chain obj_path - a path to the desired object from the object
         specified in this OS. In other words, the object specified in this
         OS is assumed to be accessible to the user, and the objects in
         the object path represent a chain of references to the desired
         object at the end of the object path. If the references are all
         valid, the desired object will be returned.
 - OR -
 list obj_ref_path - shorthand for the obj_path.
 - OR -
 ref_chain to_obj_path - identical to obj_path, except that the path
         is TO the object specified in this OS, rather than from the object.
         In other words the object specified by wsid/objid/ref etc. is the
         end of the path, and to_obj_path is the rest of the path. The user
         must have access to the first object in the to_obj_path.
 - OR -
 list to_obj_ref_path - shorthand for the to_obj_path.
 - OR -
 ref_string ref - A string representing a reference path from
         one object to another. Unlike the previous reference following
         options, the ref_string represents the ENTIRE path from the source
         object to the target object. As with the OI object, the ref field
         may contain a single reference.
 - OR -
 boolean find_refence_path - This is the last, slowest, and most expensive resort
         for getting a referenced object - do not use this method unless the
         path to the object is unavailable by any other means. Setting the
         find_refence_path parameter to true means that the workspace service will
         search through the object reference graph from the object specified
         in this OS to find an object that 1) the user can access, and 2)
         has an unbroken reference path to the target object. If the search
         succeeds, the object will be returned as normal. Note that the search
         will automatically fail after a certain (but much larger than necessary
         for the vast majority of cases) number of objects are traversed.
 OBJECT SUBSETS:
 When selecting a subset of an array in an object, the returned
 array is compressed to the size of the subset, but the ordering of
 the array is maintained. For example, if the array stored at the
 'feature' key of a Genome object has 4000 entries, and the object paths
 provided are:
         /feature/7
         /feature/3015
         /feature/700
 The returned feature array will be of length three and the entries will
 consist, in order, of the 7th, 700th, and 3015th entries of the
 original array.
 Optional object subset fields:
 list included - the portions of the object to include
                 in the object subset.
 boolean strict_maps - if true, throw an exception if the subset
         specification traverses a non-existent map key (default false)
 boolean strict_arrays - if true, throw an exception if the subset
         specification exceeds the size of an array (default true)

    • Constructor Detail

      • ObjectSpecification

        public ObjectSpecification()

    • Method Detail

      • getWorkspace

        public java.lang.String getWorkspace()

      • setWorkspace

        public void setWorkspace​(java.lang.String workspace)

      • getWsid

        public java.lang.Long getWsid()

      • setWsid

        public void setWsid​(java.lang.Long wsid)

      • getName

        public java.lang.String getName()

      • setName

        public void setName​(java.lang.String name)

      • getObjid

        public java.lang.Long getObjid()

      • setObjid

        public void setObjid​(java.lang.Long objid)

      • getVer

        public java.lang.Long getVer()

      • setVer

        public void setVer​(java.lang.Long ver)

      • getRef

        public java.lang.String getRef()

      • setRef

        public void setRef​(java.lang.String ref)

      • setObjPath

        public void setObjPath​(java.util.List<ObjectIdentity> objPath)

      • getObjRefPath

        public java.util.List<java.lang.String> getObjRefPath()

      • setObjRefPath

        public void setObjRefPath​(java.util.List<java.lang.String> objRefPath)

      • withObjRefPath

        public ObjectSpecification withObjRefPath​(java.util.List<java.lang.String> objRefPath)

      • setToObjPath

        public void setToObjPath​(java.util.List<ObjectIdentity> toObjPath)

      • getToObjRefPath

        public java.util.List<java.lang.String> getToObjRefPath()

      • setToObjRefPath

        public void setToObjRefPath​(java.util.List<java.lang.String> toObjRefPath)

      • withToObjRefPath

        public ObjectSpecification withToObjRefPath​(java.util.List<java.lang.String> toObjRefPath)

      • getFindReferencePath

        public java.lang.Long getFindReferencePath()

      • setFindReferencePath

        public void setFindReferencePath​(java.lang.Long findReferencePath)

      • withFindReferencePath

        public ObjectSpecification withFindReferencePath​(java.lang.Long findReferencePath)

      • getIncluded

        public java.util.List<java.lang.String> getIncluded()

      • setIncluded

        public void setIncluded​(java.util.List<java.lang.String> included)

      • withIncluded

        public ObjectSpecification withIncluded​(java.util.List<java.lang.String> included)

      • getStrictMaps

        public java.lang.Long getStrictMaps()

      • setStrictMaps

        public void setStrictMaps​(java.lang.Long strictMaps)

      • getStrictArrays

        public java.lang.Long getStrictArrays()

      • setStrictArrays

        public void setStrictArrays​(java.lang.Long strictArrays)

      • withStrictArrays

        public ObjectSpecification withStrictArrays​(java.lang.Long strictArrays)

      • getAdditionalProperties

        public java.util.Map<java.lang.String,​java.lang.Object> getAdditionalProperties()

      • setAdditionalProperties

        public void setAdditionalProperties​(java.lang.String name,
                                    java.lang.Object value)

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object