Interface ExpressionExperimentReadService
- All Known Implementing Classes:
ExpressionExperimentReadServiceImpl
ExpressionExperiment.
Phase 1 of the ExpressionExperimentService decomposition (strangler fig). This service
houses the pure-retrieval "bucket A" methods: load/find/exists/thaw helpers that delegate
directly to ExpressionExperimentDao with no orchestration of write-side collaborators.
Callers should generally keep using ExpressionExperimentService as the facade — the
facade delegates to this service. Direct injection is appropriate where a class would
otherwise create a Spring dependency cycle through the heavier facade
(e.g. ExpressionExperimentSetService, SampleCoexpressionAnalysisService).
ACL / @Secured annotations live on ExpressionExperimentService (the
caller-facing facade interface); enforcement happens at the facade proxy boundary.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionbrowse(int start, int limit) longcountBioMaterials(Filters filters) longcountWithCache(Filters filters, Set<Long> extraIds) booleanexistsByShortName(String shortName) filterByTaxon(Collection<Long> ids, Taxon taxon) findByAccession(String accession) findByAccession(DatabaseEntry accession) findByBioAssay(BioAssay ba, boolean includeSubSets) findByBioMaterial(BioMaterial bm, boolean includeSubSets) findByBioMaterials(Collection<BioMaterial> biomaterials) findByDesignId(Long designId) findByExpressedGene(Gene gene, double rank) findByFactor(ExperimentalFactor factor) findByFactors(Collection<ExperimentalFactor> factors) findByFactorValue(FactorValue factorValue) findByFactorValueId(Long factorValueId) findByFactorValueIds(Collection<Long> factorValueIds) findByFactorValues(Collection<FactorValue> factorValues) findByGene(Gene gene) findByName(String name) findByShortName(String shortName) findByShortNameAndThawLite(String shortName) findByShortNameWithPrimaryPublication(String shortName) findByTaxon(Taxon taxon) findByUpdatedLimit(int limit) findIdByBioAssay(BioAssay ba, boolean includeSubSets) findIdByDesign(ExperimentalDesign design) findIdByFactor(ExperimentalFactor factor) findIdByFactorValue(FactorValue factorValue) findIdsByBioMaterial(BioMaterial bm, boolean includeSubSets) findOneByAccession(String accession) findOneByName(String name) findUpdatedAfter(Date date) getAnnotations(ExpressionExperiment expressionExperiment) getAnnotations(ExpressionExperiment expressionExperiment, boolean includeFreeText) getAnnotations(ExpressionExperimentSubSet ee, boolean includeFreeText) getAnnotationsUsageFrequency(Filters filters, Set<Long> extraIds, String category, Collection<String> excludedCategoryUris, Collection<String> excludedTermUris, int minFrequency, Collection<String> retainedTermUris, int maxResults, boolean includePredicates, boolean includeObjects, long timeout, TimeUnit timeUnit) getArrayDesignUsedOrOriginalPlatformUsageFrequency(Filters filters, Set<Long> extraIds, int maxResults) longgetBioMaterialCount(ExpressionExperiment expressionExperiment) getCategoriesUsageFrequency(Filters filters, Set<Long> extraIds, Collection<String> excludedCategoryUris, Collection<String> excludedTermUris, Collection<String> retainedTermUris, int maxResults) getEnhancedFilters(Filters f, Collection<OntologyTerm> mentionedTerms, Collection<OntologyTerm> inferredTerms, long timeout, TimeUnit timeUnit) getLastArrayDesignUpdate(Collection<ExpressionExperiment> expressionExperiments) getNumberOfDesignElementsPerSample(ExpressionExperiment expressionExperiment) longgetSampleRemovalEvents(Collection<ExpressionExperiment> expressionExperiments) getTaxaUsageFrequency(Filters filters, Set<Long> extraIds) getTaxon(ExpressionExperiment expressionExperiment) Included for cycle-break parity with the facade: the only read-method back-edge fromExpressionExperimentSetServiceImplisgetTaxon.getTechnologyTypeUsageFrequency(Filters filters, Set<Long> extraIds) loadAllIdentifiersAndName(boolean includeNames) loadAndThaw(Long id) loadAndThawLite(Long id) <T extends Exception>
ExpressionExperimentloadAndThawLiteOrFail(Long id, Function<String, T> exceptionSupplier) <T extends Exception>
ExpressionExperimentloadAndThawLiteOrFail(Long id, Function<String, T> exceptionSupplier, String message) <T extends Exception>
ExpressionExperimentloadAndThawLiterOrFail(Long id, Function<String, T> exceptionSupplier) <T extends Exception>
ExpressionExperimentloadAndThawOrFail(Long id, Function<String, T> exceptionSupplier) loadBlacklistedValueObjects(Filters filters, Sort sort, int offset, int limit) loadBlacklistedValueObjectsByCursor(Filters filters, Sort sort, Cursor cursor, int limit) Cursor-mode counterpart toloadBlacklistedValueObjects(Filters, Sort, int, int).loadDetailsValueObjects(Collection<Long> ids, Taxon taxon, Sort sort, int offset, int limit) loadDetailsValueObjectsWithCache(Collection<Long> ids, Taxon taxon, Sort sort, int offset, int limit) loadIdentifiers(Collection<Long> ids) Resolve the short name and name of the given experiments, for callers that hold ids and need something a person can read.loadIdsWithCache(Filters filters, Sort sort) loadReference(Long id) loadReferences(Collection<Long> ids) loadValueObjectsByIds(List<Long> ids, boolean maintainOrder) loadValueObjectsWithCache(Filters filters, Sort sort, int offset, int limit) thaw(ExpressionExperiment expressionExperiment) thawBioAssays(ExpressionExperiment expressionExperiment) Narrow thaw used by the/samplesREST endpoint: initializes only thebioAssayscollection and appliesThaws.thawBioAssay(BioAssay)to each assay (which warms the array design, original platform, and biomaterial-with-factor-values shape thatBioAssayValueObjectreads).thawLite(ExpressionExperiment expressionExperiment) thawLiter(ExpressionExperiment expressionExperiment)
-
Method Details
-
loadReference
-
loadReferences
-
loadAllReferences
Collection<ExpressionExperiment> loadAllReferences() -
loadWithAuditTrail
-
loadTroubledIds
-
loadAllIdentifiersAndName
-
loadIdentifiers
Resolve the short name and name of the given experiments, for callers that hold ids and need something a person can read.ACL-filtered: an id the caller cannot read is absent from the result rather than throwing, so a caller labelling a list it was handed cannot learn about a dataset it could not otherwise see.
- See Also:
-
reload
-
loadWithPrimaryPublication
-
loadWithPrimaryPublicationAndOtherRelevantPublications
-
loadWithMeanVarianceRelation
-
loadWithCharacteristics
-
loadAndThaw
-
loadAndThawLite
-
loadAndThawLiteWithRefreshCacheMode
-
loadAndThawOrFail
<T extends Exception> ExpressionExperiment loadAndThawOrFail(Long id, Function<String, T> exceptionSupplier) throws T- Throws:
T
-
loadAndThawLiteOrFail
-
loadAndThawLiteOrFail
<T extends Exception> ExpressionExperiment loadAndThawLiteOrFail(Long id, Function<String, T> exceptionSupplier) throws T- Throws:
T
-
loadAndThawLiterOrFail
<T extends Exception> ExpressionExperiment loadAndThawLiterOrFail(Long id, Function<String, T> exceptionSupplier) throws T- Throws:
T
-
findByAccession
-
findByAccession
-
findOneByAccession
-
findByBibliographicReference
-
findByBioAssay
-
findByBioAssay
-
findIdByBioAssay
-
findByBioMaterial
-
findByBioMaterial
-
findIdsByBioMaterial
-
findByBioMaterials
Map<ExpressionExperiment, Collection<BioMaterial>> findByBioMaterials(Collection<BioMaterial> biomaterials) -
findByExpressedGene
-
findByDesign
-
findIdByDesign
-
findByDesignId
-
findByFactor
-
findIdByFactor
-
findByFactors
-
findByFactorValue
-
findIdByFactorValue
-
findByFactorValueId
-
findByFactorValues
-
findByFactorValueIds
-
findByGene
-
findByName
-
findOneByName
-
findByQuantitationType
-
findByShortName
-
findByShortNameWithPrimaryPublication
-
findByShortNameAndThawLite
-
findByTaxon
-
findByUpdatedLimit
-
findUpdatedAfter
-
findByMeanVarianceRelation
-
findIdByMeanVarianceRelation
-
existsByShortName
-
loadLackingFactors
Collection<ExpressionExperiment> loadLackingFactors() -
loadLackingTags
Collection<ExpressionExperiment> loadLackingTags() -
thaw
-
thawLite
-
thawLiter
-
thawBioAssays
Narrow thaw used by the/samplesREST endpoint: initializes only thebioAssayscollection and appliesThaws.thawBioAssay(BioAssay)to each assay (which warms the array design, original platform, and biomaterial-with-factor-values shape thatBioAssayValueObjectreads). Skips the nine EE-level lazy collections warmed bythawLite(ExpressionExperiment)— publications, otherParts, factors, factor values, quantitation types, characteristics, accession, mean-variance, geeq, curationDetails — none of which the assay-VO ctor reads. -
getTaxon
Included for cycle-break parity with the facade: the only read-method back-edge fromExpressionExperimentSetServiceImplisgetTaxon. Living on the read service breaks that dependency cycle. -
browse
-
filter
- Throws:
SearchException
-
filterByTaxon
-
getAnnotationCountsByIds
-
getExperimentalDesignValueObject
-
getAnnotations
-
getAnnotations
Set<AnnotationValueObject> getAnnotations(ExpressionExperiment expressionExperiment, boolean includeFreeText) - Parameters:
includeFreeText- also return annotations that carry no ontology mapping — no category URI, no value URI, or neither. These are persisted like any other tag but are excluded by default, which is correct for the tag cloud and wrong for curation read-back: a caller that has just committed a free-text tag would otherwise read back nothing and be unable to tell a rejected write from a filtered read.
-
getAnnotations
-
getAnnotations
- See Also:
-
getEnhancedFilters
Filters getEnhancedFilters(Filters f, @Nullable Collection<OntologyTerm> mentionedTerms, @Nullable Collection<OntologyTerm> inferredTerms, long timeout, TimeUnit timeUnit) throws TimeoutException - Throws:
TimeoutException
-
getNumberOfDesignElementsPerSample
-
loadIdsWithCache
-
countWithCache
-
loadValueObjectsWithCache
Slice<ExpressionExperimentValueObject> loadValueObjectsWithCache(@Nullable Filters filters, @Nullable Sort sort, int offset, int limit) -
getCategoriesUsageFrequency
Map<Characteristic, Long> getCategoriesUsageFrequency(@Nullable Filters filters, @Nullable Set<Long> extraIds, @Nullable Collection<String> excludedCategoryUris, @Nullable Collection<String> excludedTermUris, @Nullable Collection<String> retainedTermUris, int maxResults) -
getAnnotationsUsageFrequency
List<ExpressionExperimentService.CharacteristicWithUsageStatisticsAndOntologyTerm> getAnnotationsUsageFrequency(@Nullable Filters filters, @Nullable Set<Long> extraIds, @Nullable String category, @Nullable Collection<String> excludedCategoryUris, @Nullable Collection<String> excludedTermUris, int minFrequency, @Nullable Collection<String> retainedTermUris, int maxResults, boolean includePredicates, boolean includeObjects, long timeout, TimeUnit timeUnit) throws TimeoutException - Throws:
TimeoutException
-
getTechnologyTypeUsageFrequency
-
getArrayDesignUsedOrOriginalPlatformUsageFrequency
-
getTaxaUsageFrequency
-
getBioMaterialCount
-
getRawDataVectorCount
-
getExperimentsWithOutliers
Collection<ExpressionExperiment> getExperimentsWithOutliers() -
getLastArrayDesignUpdate
-
getLastArrayDesignUpdate
-
getLastLinkAnalysis
-
getLastMissingValueAnalysis
-
getLastProcessedDataUpdate
-
getPerTaxonCount
-
getPopulatedFactorCounts
-
getPopulatedFactorCountsExcludeBatch
-
getSampleRemovalEvents
Map<ExpressionExperiment, Collection<AuditEvent>> getSampleRemovalEvents(Collection<ExpressionExperiment> expressionExperiments) -
loadDetailsValueObjects
Slice<ExpressionExperimentDetailsValueObject> loadDetailsValueObjects(@Nullable Collection<Long> ids, @Nullable Taxon taxon, @Nullable Sort sort, int offset, int limit) -
loadDetailsValueObjectsWithCache
Slice<ExpressionExperimentDetailsValueObject> loadDetailsValueObjectsWithCache(Collection<Long> ids, @Nullable Taxon taxon, @Nullable Sort sort, int offset, int limit) -
loadDetailsValueObjectsByIds
-
loadDetailsValueObjectsByIdsWithCache
List<ExpressionExperimentDetailsValueObject> loadDetailsValueObjectsByIdsWithCache(Collection<Long> ids) -
loadBlacklistedValueObjects
Slice<ExpressionExperimentValueObject> loadBlacklistedValueObjects(@Nullable Filters filters, @Nullable Sort sort, int offset, int limit) -
loadBlacklistedValueObjectsByCursor
CursorPage<ExpressionExperimentValueObject> loadBlacklistedValueObjectsByCursor(@Nullable Filters filters, Sort sort, @Nullable Cursor cursor, int limit) Cursor-mode counterpart toloadBlacklistedValueObjects(Filters, Sort, int, int).- See Also:
-
loadValueObjectsByIdsWithRelationsAndCache
-
loadValueObjectsByIds
-
countBioMaterials
-