Package ome.model.acquisition
Class Dichroic
- java.lang.Object
-
- ome.model.acquisition.Dichroic
-
- All Implemented Interfaces:
java.io.Serializable
,IAnnotated
,IMutable
,IObject
,Filterable
@Entity @Indexed(index="FullText") @ClassBridge(name="details", impl=DetailsFieldBridge.class, index=UN_TOKENIZED, store=NO) public class Dichroic extends java.lang.Object implements java.io.Serializable, IObject, IMutable, IAnnotated
These filter definitions are used by the security system to eliminate non-readable objects from queries. The regular user does not need to worry about them, as they will be injected directly into the SQL (not HQL)- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Dichroic.Details
-
Field Summary
Fields Modifier and Type Field Description protected java.util.Map<java.lang.String,java.lang.Object>
_dynamicFields
protected boolean
_loaded
protected java.util.Set<DichroicAnnotationLink>
annotationLinks
static java.lang.String
ANNOTATIONLINKS
static java.lang.String
ANNOTATIONLINKSCOUNTPEROWNER
protected Details
details
static java.lang.String
DETAILS
static java.lang.String
EVENT_FILTER
static java.lang.String
EVENT_FILTER_ANNOTATIONLINKS
static java.util.Set<java.lang.String>
FIELDS
static java.lang.String
GROUP_FILTER
static java.lang.String
GROUP_FILTER_ANNOTATIONLINKS
protected java.lang.Long
id
static java.lang.String
ID
protected Instrument
instrument
static java.lang.String
INSTRUMENT
protected java.lang.String
lotNumber
static java.lang.String
LOTNUMBER
protected java.lang.String
manufacturer
static java.lang.String
MANUFACTURER
protected java.lang.String
model
static java.lang.String
MODEL
static java.lang.String
OWNER_FILTER
static java.lang.String
OWNER_FILTER_ANNOTATIONLINKS
static java.lang.String
PERMS_FILTER
static java.lang.String
PERMS_FILTER_ANNOTATIONLINKS
protected java.lang.String
serialNumber
static java.lang.String
SERIALNUMBER
protected java.lang.Integer
version
static java.lang.String
VERSION
-
Constructor Summary
Constructors Modifier Constructor Description Dichroic()
protected
Dichroic(java.lang.Long id)
Dichroic(java.lang.Long id, boolean loaded)
Main constructor.Dichroic(Instrument _instrument)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
acceptFilter(Filter __filter)
void
addDichroicAnnotationLink(DichroicAnnotationLink target)
use instead of setAnnotationLinks .void
addDichroicAnnotationLink(DichroicAnnotationLink link, boolean bothSides)
Adds a ome.model.annotations.DichroicAnnotationLink to annotationLinks, allowing for recursion -- whether or not addDichroicAnnotationLink will be called on the addition if it is loadedvoid
addDichroicAnnotationLinkSet(java.util.Collection<DichroicAnnotationLink> targets)
use like addDichroicAnnotationLink.void
clearAnnotationLinks()
clears the set.<E> java.util.List<E>
collectAnnotationLinks(CBlock<E> block)
takes a CBlock and calls the block once for each ome.model.annotations.DichroicAnnotationLink while collecting the results.<E> java.util.List<E>
eachLinkedAnnotation(CBlock<E> block)
takes a CBlock and calls the block once for each ome.model.annotations.Annotation while collecting the results.protected void
errorIfUnloaded()
java.util.Set<java.lang.String>
fields()
returns a Set of field names that belong to this classjava.util.Set<DichroicAnnotationLink>
findDichroicAnnotationLink(Annotation target)
find all ome.model.annotations.DichroicAnnotationLink which have the argument as their child.protected java.util.Set<DichroicAnnotationLink>
getAnnotationLinks()
returns annotationLinks .java.util.Map<java.lang.Long,java.lang.Long>
getAnnotationLinksCountPerOwner()
If fetched, returns the count(*) of ome.model.annotations.DichroicAnnotationLink that a user has.Details
getDetails()
The details of this object correspond to low-level system information.GraphHolder
getGraphHolder()
retrieves theGraphHolder
for this entity.java.lang.Long
getId()
The DB unique identifier for this object.Instrument
getInstrument()
Many-to-one field ome.model.acquisition.Dichroic.instrument (ome.model.acquisition.Instrument)java.lang.String
getLotNumber()
Simple field ome.model.acquisition.Dichroic.lotNumber (java.lang.String)java.lang.String
getManufacturer()
Simple field ome.model.acquisition.Dichroic.manufacturer (java.lang.String)java.lang.String
getModel()
Simple field ome.model.acquisition.Dichroic.model (java.lang.String)java.lang.String
getSerialNumber()
Simple field ome.model.acquisition.Dichroic.serialNumber (java.lang.String)java.lang.Integer
getVersion()
This version number is controlled by the database for optimisitic locking.boolean
isLoaded()
transient field (not stored in the DB) which specifies whether this object has been loaded from the DB or is only a wrapper around the ID.boolean
isValid()
calls the class-specific validator for this instance and returns the value fromValidation.isValid()
java.util.Iterator<DichroicAnnotationLink>
iterateAnnotationLinks()
should be used rather than accessing the annotationLinks set directly.DichroicAnnotationLink
linkAnnotation(Annotation addition)
Adds a ome.model.annotations.DichroicAnnotationLink to annotationLinks .java.util.Iterator<Annotation>
linkedAnnotationIterator()
provides an iterator over the parent values of the annotationLinks.java.util.List<Annotation>
linkedAnnotationList()
produces aList
-copy of the underlying collection.Dichroic
newInstance()
Dichroic
proxy()
void
putAt(java.lang.String field, java.lang.Object value)
stores a value in this instance.void
removeDichroicAnnotationLink(DichroicAnnotationLink target)
removes a single element from this set and makes the inverse call on ome.model.annotations.DichroicAnnotationLinkvoid
removeDichroicAnnotationLink(DichroicAnnotationLink link, boolean bothSides)
removes the given DichroicAnnotationLink from annotationLinks, allowing for recursion -- whether or not the removal will call unlinkDichroic again if loaded.void
removeDichroicAnnotationLinkSet(java.util.Collection<DichroicAnnotationLink> targets)
use like removeDichroicAnnotationLinkjava.lang.Object
retrieve(java.lang.String field)
retrieves a value from this instance.protected void
setAnnotationLinks(java.util.Set<DichroicAnnotationLink> annotationLinks)
setter for annotationLinks should be avoided.protected void
setAnnotationLinksCountPerOwner(java.util.Map<java.lang.Long,java.lang.Long> map)
protected void
setDetails(Details details)
void
setId(java.lang.Long id)
usually unneeded.void
setInstrument(Instrument instrument)
void
setLotNumber(java.lang.String lotNumber)
void
setManufacturer(java.lang.String manufacturer)
void
setModel(java.lang.String model)
void
setSerialNumber(java.lang.String serialNumber)
void
setVersion(java.lang.Integer version)
use with caution.int
sizeOfAnnotationLinks()
returns the size of annotationLinks.protected void
throwNullCollectionException(java.lang.String propertyName)
java.lang.String
toString()
void
unlinkAnnotation(Annotation removal)
unlinks all ome.model.annotations.Annotation instances from this instance.void
unload()
set the loaded field to false, and set all non-ID fields to null.java.util.Collection<DichroicAnnotationLink>
unmodifiableAnnotationLinks()
Returns an unmodifiable collection-viewValidation
validate()
calls the class-specific validator for this instance and returns theValidation
object.
-
-
-
Field Detail
-
OWNER_FILTER
public static final java.lang.String OWNER_FILTER
- See Also:
- Constant Field Values
-
GROUP_FILTER
public static final java.lang.String GROUP_FILTER
- See Also:
- Constant Field Values
-
EVENT_FILTER
public static final java.lang.String EVENT_FILTER
- See Also:
- Constant Field Values
-
PERMS_FILTER
public static final java.lang.String PERMS_FILTER
- See Also:
- Constant Field Values
-
ID
public static final java.lang.String ID
- See Also:
- Constant Field Values
-
id
protected java.lang.Long id
-
VERSION
public static final java.lang.String VERSION
- See Also:
- Constant Field Values
-
version
protected java.lang.Integer version
-
manufacturer
protected java.lang.String manufacturer
-
model
protected java.lang.String model
-
lotNumber
protected java.lang.String lotNumber
-
serialNumber
protected java.lang.String serialNumber
-
instrument
protected Instrument instrument
-
annotationLinks
protected java.util.Set<DichroicAnnotationLink> annotationLinks
-
OWNER_FILTER_ANNOTATIONLINKS
public static final java.lang.String OWNER_FILTER_ANNOTATIONLINKS
- See Also:
- Constant Field Values
-
GROUP_FILTER_ANNOTATIONLINKS
public static final java.lang.String GROUP_FILTER_ANNOTATIONLINKS
- See Also:
- Constant Field Values
-
EVENT_FILTER_ANNOTATIONLINKS
public static final java.lang.String EVENT_FILTER_ANNOTATIONLINKS
- See Also:
- Constant Field Values
-
PERMS_FILTER_ANNOTATIONLINKS
public static final java.lang.String PERMS_FILTER_ANNOTATIONLINKS
- See Also:
- Constant Field Values
-
details
protected Details details
-
MANUFACTURER
public static final java.lang.String MANUFACTURER
- See Also:
- Constant Field Values
-
MODEL
public static final java.lang.String MODEL
- See Also:
- Constant Field Values
-
LOTNUMBER
public static final java.lang.String LOTNUMBER
- See Also:
- Constant Field Values
-
SERIALNUMBER
public static final java.lang.String SERIALNUMBER
- See Also:
- Constant Field Values
-
INSTRUMENT
public static final java.lang.String INSTRUMENT
- See Also:
- Constant Field Values
-
ANNOTATIONLINKSCOUNTPEROWNER
public static final java.lang.String ANNOTATIONLINKSCOUNTPEROWNER
- See Also:
- Constant Field Values
-
ANNOTATIONLINKS
public static final java.lang.String ANNOTATIONLINKS
- See Also:
- Constant Field Values
-
DETAILS
public static final java.lang.String DETAILS
- See Also:
- Constant Field Values
-
FIELDS
public static final java.util.Set<java.lang.String> FIELDS
-
_dynamicFields
protected java.util.Map<java.lang.String,java.lang.Object> _dynamicFields
-
_loaded
protected boolean _loaded
-
-
Constructor Detail
-
Dichroic
public Dichroic()
-
Dichroic
protected Dichroic(java.lang.Long id)
-
Dichroic
public Dichroic(java.lang.Long id, boolean loaded)
Main constructor.
-
Dichroic
public Dichroic(Instrument _instrument)
-
-
Method Detail
-
getId
@DocumentId public java.lang.Long getId()
The DB unique identifier for this object. You are not responsible for setting the id; however, it can be useful for creating "unloaded" versions of your objects. Each top-level entity contains an id field of type long. For all objects returned from the server, this value will be non-null, which doesn't necessarily hold for the other fields.
-
setId
public void setId(java.lang.Long id)
Description copied from interface:IObject
usually unneeded. Ids are managed by the backend.
-
getVersion
public java.lang.Integer getVersion()
This version number is controlled by the database for optimisitic locking.- Specified by:
getVersion
in interfaceIMutable
-
setVersion
public void setVersion(java.lang.Integer version)
Description copied from interface:IMutable
use with caution. In general, the version should only be altered by the backend. In the best case, an exception will be thrown for a version not equal to the current DB value. In the worst (though rare) case, the new version could match the database, and override optimistic lock checks that are supposed to prevent data loss.- Specified by:
setVersion
in interfaceIMutable
- Parameters:
version
- Value for this objects version.
-
getManufacturer
@Field(index=TOKENIZED) @Field(index=TOKENIZED,analyzer=@Analyzer(impl=ConfiguredAnalyzer.class),name="combined_fields") public java.lang.String getManufacturer()
Simple field ome.model.acquisition.Dichroic.manufacturer (java.lang.String)
-
setManufacturer
public void setManufacturer(java.lang.String manufacturer)
-
getModel
@Field(index=TOKENIZED) @Field(index=TOKENIZED,analyzer=@Analyzer(impl=ConfiguredAnalyzer.class),name="combined_fields") public java.lang.String getModel()
Simple field ome.model.acquisition.Dichroic.model (java.lang.String)
-
setModel
public void setModel(java.lang.String model)
-
getLotNumber
@Field(index=TOKENIZED) @Field(index=TOKENIZED,analyzer=@Analyzer(impl=ConfiguredAnalyzer.class),name="combined_fields") public java.lang.String getLotNumber()
Simple field ome.model.acquisition.Dichroic.lotNumber (java.lang.String)
-
setLotNumber
public void setLotNumber(java.lang.String lotNumber)
-
getSerialNumber
@Field(index=TOKENIZED) @Field(index=TOKENIZED,analyzer=@Analyzer(impl=ConfiguredAnalyzer.class),name="combined_fields") public java.lang.String getSerialNumber()
Simple field ome.model.acquisition.Dichroic.serialNumber (java.lang.String)
-
setSerialNumber
public void setSerialNumber(java.lang.String serialNumber)
-
getInstrument
public Instrument getInstrument()
Many-to-one field ome.model.acquisition.Dichroic.instrument (ome.model.acquisition.Instrument)
-
setInstrument
public void setInstrument(Instrument instrument)
-
getAnnotationLinks
protected java.util.Set<DichroicAnnotationLink> getAnnotationLinks()
returns annotationLinks . You should not modify this collection unless you know what you are doing. Use the iterate method instead. one-to-many Set ome.model.acquisition.Dichroic.annotationLinks (ome.model.annotations.DichroicAnnotationLink)
-
setAnnotationLinks
protected void setAnnotationLinks(java.util.Set<DichroicAnnotationLink> annotationLinks)
setter for annotationLinks should be avoided. Does not fulfill normal semantics.
-
sizeOfAnnotationLinks
public int sizeOfAnnotationLinks()
returns the size of annotationLinks. If less than zero, the Set was null.- Specified by:
sizeOfAnnotationLinks
in interfaceIAnnotated
-
iterateAnnotationLinks
public java.util.Iterator<DichroicAnnotationLink> iterateAnnotationLinks()
should be used rather than accessing the annotationLinks set directly. This method will never return null, but rather will return an instance ofEmptyIterator
. To test for a null collection, see ofsizeOfAnnotationLinks()
is less than zero.- Specified by:
iterateAnnotationLinks
in interfaceIAnnotated
-
unmodifiableAnnotationLinks
public java.util.Collection<DichroicAnnotationLink> unmodifiableAnnotationLinks()
Returns an unmodifiable collection-view- Specified by:
unmodifiableAnnotationLinks
in interfaceIAnnotated
-
collectAnnotationLinks
public <E> java.util.List<E> collectAnnotationLinks(CBlock<E> block)
takes a CBlock and calls the block once for each ome.model.annotations.DichroicAnnotationLink while collecting the results. Ifblock == null
, then the iterator values themselves are collected. This method usesiterateAnnotationLinks()
internally and so will return a value even if the underlying collection is null.- Specified by:
collectAnnotationLinks
in interfaceIAnnotated
-
addDichroicAnnotationLink
public void addDichroicAnnotationLink(DichroicAnnotationLink target)
use instead of setAnnotationLinks . Makes the necessary call on ome.model.annotations.DichroicAnnotationLink as well.
-
addDichroicAnnotationLinkSet
public void addDichroicAnnotationLinkSet(java.util.Collection<DichroicAnnotationLink> targets)
use like addDichroicAnnotationLink.
-
removeDichroicAnnotationLink
public void removeDichroicAnnotationLink(DichroicAnnotationLink target)
removes a single element from this set and makes the inverse call on ome.model.annotations.DichroicAnnotationLink
-
removeDichroicAnnotationLinkSet
public void removeDichroicAnnotationLinkSet(java.util.Collection<DichroicAnnotationLink> targets)
use like removeDichroicAnnotationLink
-
linkAnnotation
public DichroicAnnotationLink linkAnnotation(Annotation addition)
Adds a ome.model.annotations.DichroicAnnotationLink to annotationLinks . This entails changing our annotationLinks Set, creating a new ome.model.annotations.DichroicAnnotationLink and calling linkAnnotation on the ome.model.annotations.Annotation.- Specified by:
linkAnnotation
in interfaceIAnnotated
-
addDichroicAnnotationLink
public void addDichroicAnnotationLink(DichroicAnnotationLink link, boolean bothSides)
Adds a ome.model.annotations.DichroicAnnotationLink to annotationLinks, allowing for recursion -- whether or not addDichroicAnnotationLink will be called on the addition if it is loaded
-
linkedAnnotationIterator
public java.util.Iterator<Annotation> linkedAnnotationIterator()
provides an iterator over the parent values of the annotationLinks. Like with most Collection iterators, modifications to the underlying collection while iterating will result in anConcurrentModificationException
. UselinkedAnnotationList()
instead.- Specified by:
linkedAnnotationIterator
in interfaceIAnnotated
-
findDichroicAnnotationLink
public java.util.Set<DichroicAnnotationLink> findDichroicAnnotationLink(Annotation target)
find all ome.model.annotations.DichroicAnnotationLink which have the argument as their child.
-
linkedAnnotationList
public java.util.List<Annotation> linkedAnnotationList()
produces aList
-copy of the underlying collection. Unlike,linkedAnnotationIterator()
, while using the returnedList
, modifications can be made to the underlying collection without throwingConcurrentModificationException
.- Specified by:
linkedAnnotationList
in interfaceIAnnotated
-
eachLinkedAnnotation
public <E> java.util.List<E> eachLinkedAnnotation(CBlock<E> block)
takes a CBlock and calls the block once for each ome.model.annotations.Annotation while collecting the results. Ifblock == null
, then the iterator values themselves are collected.- Specified by:
eachLinkedAnnotation
in interfaceIAnnotated
-
unlinkAnnotation
public void unlinkAnnotation(Annotation removal)
unlinks all ome.model.annotations.Annotation instances from this instance.- Specified by:
unlinkAnnotation
in interfaceIAnnotated
-
removeDichroicAnnotationLink
public void removeDichroicAnnotationLink(DichroicAnnotationLink link, boolean bothSides)
removes the given DichroicAnnotationLink from annotationLinks, allowing for recursion -- whether or not the removal will call unlinkDichroic again if loaded.
-
clearAnnotationLinks
public void clearAnnotationLinks()
clears the set.- Specified by:
clearAnnotationLinks
in interfaceIAnnotated
-
setAnnotationLinksCountPerOwner
protected void setAnnotationLinksCountPerOwner(java.util.Map<java.lang.Long,java.lang.Long> map)
-
getAnnotationLinksCountPerOwner
public java.util.Map<java.lang.Long,java.lang.Long> getAnnotationLinksCountPerOwner()
If fetched, returns the count(*) of ome.model.annotations.DichroicAnnotationLink that a user has. If unfetched, returns null. No entries in the collection should be null.
-
getDetails
public Details getDetails()
The details of this object correspond to low-level system information. Owner, permissions, Details is always guaranteed to be non-null, unless the user actively nulls it. Every entity also contains a Detail reference, which doesn't refer to a separate table but rather to a collection of fields collected into a Hibernate "component" which is embedded in the object. HQL queries which refer to the Details component cannot directly fetch the entity like this: select o from Object join fetch o.details but rather each field of the Details instance must be explicitly joined: select o from Object join fetch o.details.owner It should also be noted that not all types have all the fields which are present on Details. For example, select e from Experimenter e join fetch e.details.owner will fail. Experimenter has no owner, for obvious reasons. Note: subclasses of this class will return a subclass of theDetails
type.- Specified by:
getDetails
in interfaceIObject
-
setDetails
protected void setDetails(Details details)
-
isValid
public boolean isValid()
Description copied from interface:IObject
calls the class-specific validator for this instance and returns the value fromValidation.isValid()
-
validate
public Validation validate()
Description copied from interface:IObject
calls the class-specific validator for this instance and returns theValidation
object.
-
newInstance
public Dichroic newInstance()
-
proxy
public Dichroic proxy()
-
acceptFilter
public boolean acceptFilter(Filter __filter)
- Specified by:
acceptFilter
in interfaceFilterable
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
fields
public java.util.Set<java.lang.String> fields()
Description copied from interface:IObject
returns a Set of field names that belong to this class
-
retrieve
public java.lang.Object retrieve(java.lang.String field)
Description copied from interface:IObject
retrieves a value from this instance. Values forfield
which match a field of this instance will be delegated to the accessors. Otherwise, values will be retrieved from a lazy-loaded map filled by calls toIObject.putAt(String, Object)
-
putAt
public void putAt(java.lang.String field, java.lang.Object value)
Description copied from interface:IObject
stores a value in this instance. Values forfield
which match a field of this instance will be delegated to the accessors. Otherwise, values will be stored in a lazy-loaded map.
-
isLoaded
public boolean isLoaded()
Description copied from interface:IObject
transient field (not stored in the DB) which specifies whether this object has been loaded from the DB or is only a wrapper around the ID.
-
errorIfUnloaded
protected void errorIfUnloaded()
-
unload
public void unload()
Description copied from interface:IObject
set the loaded field to false, and set all non-ID fields to null. Subsequent calls to all accessors other than getId/setId will throw an ApiUsageException
-
getGraphHolder
public final GraphHolder getGraphHolder()
Description copied from interface:IObject
retrieves theGraphHolder
for this entity. If the GraphHolder has not been actively set, a new one will be instatiated.- Specified by:
getGraphHolder
in interfaceIObject
- Returns:
- Non-null GraphHolder
-
throwNullCollectionException
protected void throwNullCollectionException(java.lang.String propertyName)
-
-