
001 002package ca.uhn.fhir.jpa.rp.r5; 003 004import java.util.*; 005 006import org.apache.commons.lang3.StringUtils; 007 008import ca.uhn.fhir.jpa.searchparam.SearchParameterMap; 009import ca.uhn.fhir.model.api.Include; 010import ca.uhn.fhir.model.api.annotation.*; 011import org.hl7.fhir.r5.model.*; 012import ca.uhn.fhir.rest.annotation.*; 013import ca.uhn.fhir.rest.param.*; 014import ca.uhn.fhir.rest.api.SortSpec; 015import ca.uhn.fhir.rest.api.SummaryEnum; 016import ca.uhn.fhir.rest.api.SearchTotalModeEnum; 017import ca.uhn.fhir.rest.api.SearchContainedModeEnum; 018 019public class DocumentReferenceResourceProvider extends 020 ca.uhn.fhir.jpa.provider.BaseJpaResourceProvider<DocumentReference> 021 { 022 023 @Override 024 public Class<DocumentReference> getResourceType() { 025 return DocumentReference.class; 026 } 027 028 @Search(allowUnknownParams=true) 029 public ca.uhn.fhir.rest.api.server.IBundleProvider search( 030 jakarta.servlet.http.HttpServletRequest theServletRequest, 031 jakarta.servlet.http.HttpServletResponse theServletResponse, 032 033 ca.uhn.fhir.rest.api.server.RequestDetails theRequestDetails, 034 035 @Description(shortDefinition="Search the contents of the resource's data using a filter") 036 @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_FILTER) 037 StringAndListParam theFtFilter, 038 039 @Description(shortDefinition="Search the contents of the resource's data using a fulltext search") 040 @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_CONTENT) 041 StringAndListParam theFtContent, 042 043 @Description(shortDefinition="Search the contents of the resource's narrative using a fulltext search") 044 @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_TEXT) 045 StringAndListParam theFtText, 046 047 048 @Description(shortDefinition="Search the contents of the resource's data using a list") 049 @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_LIST) 050 StringAndListParam theList, 051 052 @Description(shortDefinition="The language of the resource") 053 @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_LANGUAGE) 054 TokenAndListParam theResourceLanguage, 055 056 @Description(shortDefinition="Search for resources which have the given source value (Resource.meta.source)") 057 @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_SOURCE) 058 UriAndListParam theSearchForSource, 059 060 @Description(shortDefinition="Return resources linked to by the given target") 061 @OptionalParam(name="_has") 062 HasAndListParam theHas, 063 064 065 066 @Description(shortDefinition="The ID of the resource") 067 @OptionalParam(name="_id") 068 TokenAndListParam the_id, 069 070 071 @Description(shortDefinition="Only return resources which were last updated as specified by the given range") 072 @OptionalParam(name="_lastUpdated") 073 DateRangeParam the_lastUpdated, 074 075 076 @Description(shortDefinition="The profile of the resource") 077 @OptionalParam(name="_profile") 078 UriAndListParam the_profile, 079 080 081 @Description(shortDefinition="The security of the resource") 082 @OptionalParam(name="_security") 083 TokenAndListParam the_security, 084 085 086 @Description(shortDefinition="The tag of the resource") 087 @OptionalParam(name="_tag") 088 TokenAndListParam the_tag, 089 090 091 @Description(shortDefinition="Search on the narrative of the resource") 092 @OptionalParam(name="_text") 093 SpecialAndListParam the_text, 094 095 096 @Description(shortDefinition="Who attested the document") 097 @OptionalParam(name="attester", targetTypes={ } ) 098 ReferenceAndListParam theAttester, 099 100 101 @Description(shortDefinition="Who and/or what authored the document") 102 @OptionalParam(name="author", targetTypes={ } ) 103 ReferenceAndListParam theAuthor, 104 105 106 @Description(shortDefinition="Procedure that caused this media to be created") 107 @OptionalParam(name="based-on", targetTypes={ } ) 108 ReferenceAndListParam theBased_on, 109 110 111 @Description(shortDefinition="The body site studied") 112 @OptionalParam(name="bodysite") 113 TokenAndListParam theBodysite, 114 115 116 @Description(shortDefinition="The body site studied") 117 @OptionalParam(name="bodysite-reference", targetTypes={ } ) 118 ReferenceAndListParam theBodysite_reference, 119 120 121 @Description(shortDefinition="Categorization of document") 122 @OptionalParam(name="category") 123 TokenAndListParam theCategory, 124 125 126 @Description(shortDefinition="Mime type of the content, with charset etc.") 127 @OptionalParam(name="contenttype") 128 TokenAndListParam theContenttype, 129 130 131 @Description(shortDefinition="Context of the document content") 132 @OptionalParam(name="context", targetTypes={ } ) 133 ReferenceAndListParam theContext, 134 135 136 @Description(shortDefinition="Date attachment was first created") 137 @OptionalParam(name="creation") 138 DateRangeParam theCreation, 139 140 141 @Description(shortDefinition="Organization which maintains the document") 142 @OptionalParam(name="custodian", targetTypes={ } ) 143 ReferenceAndListParam theCustodian, 144 145 146 @Description(shortDefinition="Multiple Resources: * [AdverseEvent](adverseevent.html): When the event occurred* [AllergyIntolerance](allergyintolerance.html): Date first version of the resource instance was recorded* [Appointment](appointment.html): Appointment date/time.* [AuditEvent](auditevent.html): Time when the event was recorded* [CarePlan](careplan.html): Time period plan covers* [CareTeam](careteam.html): A date within the coverage time period.* [ClinicalImpression](clinicalimpression.html): When the assessment was documented* [Composition](composition.html): Composition editing time* [Consent](consent.html): When consent was agreed to* [DiagnosticReport](diagnosticreport.html): The clinically relevant time of the report* [DocumentReference](documentreference.html): When this document reference was created* [Encounter](encounter.html): A date within the actualPeriod the Encounter lasted* [EpisodeOfCare](episodeofcare.html): The provided date search value falls within the episode of care's period* [FamilyMemberHistory](familymemberhistory.html): When history was recorded or last updated* [Flag](flag.html): Time period when flag is active* [Immunization](immunization.html): Vaccination (non)-Administration Date* [ImmunizationEvaluation](immunizationevaluation.html): Date the evaluation was generated* [ImmunizationRecommendation](immunizationrecommendation.html): Date recommendation(s) created* [Invoice](invoice.html): Invoice date / posting date* [List](list.html): When the list was prepared* [MeasureReport](measurereport.html): The date of the measure report* [NutritionIntake](nutritionintake.html): Date when patient was taking (or not taking) the medication* [Observation](observation.html): Clinically relevant time/time-period for observation* [Procedure](procedure.html): When the procedure occurred or is occurring* [ResearchSubject](researchsubject.html): Start and end of participation* [RiskAssessment](riskassessment.html): When was assessment made?* [SupplyRequest](supplyrequest.html): When the request was made") 147 @OptionalParam(name="date") 148 DateRangeParam theDate, 149 150 151 @Description(shortDefinition="Human-readable description") 152 @OptionalParam(name="description") 153 StringAndListParam theDescription, 154 155 156 @Description(shortDefinition="preliminary | final | amended | entered-in-error") 157 @OptionalParam(name="doc-status") 158 TokenAndListParam theDoc_status, 159 160 161 @Description(shortDefinition="Main clinical acts documented") 162 @OptionalParam(name="event-code") 163 TokenAndListParam theEvent_code, 164 165 166 @Description(shortDefinition="Main clinical acts documented") 167 @OptionalParam(name="event-reference", targetTypes={ } ) 168 ReferenceAndListParam theEvent_reference, 169 170 171 @Description(shortDefinition="Kind of facility where patient was seen") 172 @OptionalParam(name="facility") 173 TokenAndListParam theFacility, 174 175 176 @Description(shortDefinition="Profile canonical content rules for the document") 177 @OptionalParam(name="format-canonical", targetTypes={ } ) 178 ReferenceAndListParam theFormat_canonical, 179 180 181 @Description(shortDefinition="Format code content rules for the document") 182 @OptionalParam(name="format-code") 183 TokenAndListParam theFormat_code, 184 185 186 @Description(shortDefinition="Profile URI content rules for the document") 187 @OptionalParam(name="format-uri") 188 UriAndListParam theFormat_uri, 189 190 191 @Description(shortDefinition="Multiple Resources: * [Account](account.html): Account number* [AdverseEvent](adverseevent.html): Business identifier for the event* [AllergyIntolerance](allergyintolerance.html): External ids for this item* [Appointment](appointment.html): An Identifier of the Appointment* [AppointmentResponse](appointmentresponse.html): An Identifier in this appointment response* [Basic](basic.html): Business identifier* [BodyStructure](bodystructure.html): Bodystructure identifier* [CarePlan](careplan.html): External Ids for this plan* [CareTeam](careteam.html): External Ids for this team* [ChargeItem](chargeitem.html): Business Identifier for item* [Claim](claim.html): The primary identifier of the financial resource* [ClaimResponse](claimresponse.html): The identity of the ClaimResponse* [ClinicalImpression](clinicalimpression.html): Business identifier* [Communication](communication.html): Unique identifier* [CommunicationRequest](communicationrequest.html): Unique identifier* [Composition](composition.html): Version-independent identifier for the Composition* [Condition](condition.html): A unique identifier of the condition record* [Consent](consent.html): Identifier for this record (external references)* [Contract](contract.html): The identity of the contract* [Coverage](coverage.html): The primary identifier of the insured and the coverage* [CoverageEligibilityRequest](coverageeligibilityrequest.html): The business identifier of the Eligibility* [CoverageEligibilityResponse](coverageeligibilityresponse.html): The business identifier* [DetectedIssue](detectedissue.html): Unique id for the detected issue* [DeviceRequest](devicerequest.html): Business identifier for request/order* [DeviceUsage](deviceusage.html): Search by identifier* [DiagnosticReport](diagnosticreport.html): An identifier for the report* [DocumentReference](documentreference.html): Identifier of the attachment binary* [Encounter](encounter.html): Identifier(s) by which this encounter is known* [EnrollmentRequest](enrollmentrequest.html): The business identifier of the Enrollment* [EpisodeOfCare](episodeofcare.html): Business Identifier(s) relevant for this EpisodeOfCare* [ExplanationOfBenefit](explanationofbenefit.html): The business identifier of the Explanation of Benefit* [FamilyMemberHistory](familymemberhistory.html): A search by a record identifier* [Flag](flag.html): Business identifier* [Goal](goal.html): External Ids for this goal* [GuidanceResponse](guidanceresponse.html): The identifier of the guidance response* [ImagingSelection](imagingselection.html): Identifiers for the imaging selection* [ImagingStudy](imagingstudy.html): Identifiers for the Study, such as DICOM Study Instance UID* [Immunization](immunization.html): Business identifier* [ImmunizationEvaluation](immunizationevaluation.html): ID of the evaluation* [ImmunizationRecommendation](immunizationrecommendation.html): Business identifier* [Invoice](invoice.html): Business Identifier for item* [List](list.html): Business identifier* [MeasureReport](measurereport.html): External identifier of the measure report to be returned* [Medication](medication.html): Returns medications with this external identifier* [MedicationAdministration](medicationadministration.html): Return administrations with this external identifier* [MedicationDispense](medicationdispense.html): Returns dispenses with this external identifier* [MedicationRequest](medicationrequest.html): Return prescriptions with this external identifier* [MedicationStatement](medicationstatement.html): Return statements with this external identifier* [MolecularSequence](molecularsequence.html): The unique identity for a particular sequence* [NutritionIntake](nutritionintake.html): Return statements with this external identifier* [NutritionOrder](nutritionorder.html): Return nutrition orders with this external identifier* [Observation](observation.html): The unique id for a particular observation* [Person](person.html): A person Identifier* [Procedure](procedure.html): A unique identifier for a procedure* [QuestionnaireResponse](questionnaireresponse.html): The unique identifier for the questionnaire response* [RelatedPerson](relatedperson.html): An Identifier of the RelatedPerson* [RequestOrchestration](requestorchestration.html): External identifiers for the request orchestration* [ResearchSubject](researchsubject.html): Business Identifier for research subject in a study* [RiskAssessment](riskassessment.html): Unique identifier for the assessment* [ServiceRequest](servicerequest.html): Identifiers assigned to this order* [Specimen](specimen.html): The unique identifier associated with the specimen* [SupplyDelivery](supplydelivery.html): External identifier* [SupplyRequest](supplyrequest.html): Business Identifier for SupplyRequest* [Task](task.html): Search for a task instance by its business identifier* [VisionPrescription](visionprescription.html): Return prescriptions with this external identifier") 192 @OptionalParam(name="identifier") 193 TokenAndListParam theIdentifier, 194 195 196 @Description(shortDefinition="Human language of the content (BCP-47)") 197 @OptionalParam(name="language") 198 TokenAndListParam theLanguage, 199 200 201 @Description(shortDefinition="Uri where the data can be found") 202 @OptionalParam(name="location") 203 UriAndListParam theLocation, 204 205 206 @Description(shortDefinition="The modality used") 207 @OptionalParam(name="modality") 208 TokenAndListParam theModality, 209 210 211 @Description(shortDefinition="Multiple Resources: * [Account](account.html): The entity that caused the expenses* [AdverseEvent](adverseevent.html): Subject impacted by event* [AllergyIntolerance](allergyintolerance.html): Who the sensitivity is for* [Appointment](appointment.html): One of the individuals of the appointment is this patient* [AppointmentResponse](appointmentresponse.html): This Response is for this Patient* [AuditEvent](auditevent.html): Where the activity involved patient data* [Basic](basic.html): Identifies the focus of this resource* [BodyStructure](bodystructure.html): Who this is about* [CarePlan](careplan.html): Who the care plan is for* [CareTeam](careteam.html): Who care team is for* [ChargeItem](chargeitem.html): Individual service was done for/to* [Claim](claim.html): Patient receiving the products or services* [ClaimResponse](claimresponse.html): The subject of care* [ClinicalImpression](clinicalimpression.html): Patient assessed* [Communication](communication.html): Focus of message* [CommunicationRequest](communicationrequest.html): Focus of message* [Composition](composition.html): Who and/or what the composition is about* [Condition](condition.html): Who has the condition?* [Consent](consent.html): Who the consent applies to* [Contract](contract.html): The identity of the subject of the contract (if a patient)* [Coverage](coverage.html): Retrieve coverages for a patient* [CoverageEligibilityRequest](coverageeligibilityrequest.html): The reference to the patient* [CoverageEligibilityResponse](coverageeligibilityresponse.html): The reference to the patient* [DetectedIssue](detectedissue.html): Associated patient* [DeviceRequest](devicerequest.html): Individual the service is ordered for* [DeviceUsage](deviceusage.html): Search by patient who used / uses the device* [DiagnosticReport](diagnosticreport.html): The subject of the report if a patient* [DocumentReference](documentreference.html): Who/what is the subject of the document* [Encounter](encounter.html): The patient present at the encounter* [EnrollmentRequest](enrollmentrequest.html): The party to be enrolled* [EpisodeOfCare](episodeofcare.html): The patient who is the focus of this episode of care* [ExplanationOfBenefit](explanationofbenefit.html): The reference to the patient* [FamilyMemberHistory](familymemberhistory.html): The identity of a subject to list family member history items for* [Flag](flag.html): The identity of a subject to list flags for* [Goal](goal.html): Who this goal is intended for* [GuidanceResponse](guidanceresponse.html): The identity of a patient to search for guidance response results* [ImagingSelection](imagingselection.html): Who the study is about* [ImagingStudy](imagingstudy.html): Who the study is about* [Immunization](immunization.html): The patient for the vaccination record* [ImmunizationEvaluation](immunizationevaluation.html): The patient being evaluated* [ImmunizationRecommendation](immunizationrecommendation.html): Who this profile is for* [Invoice](invoice.html): Recipient(s) of goods and services* [List](list.html): If all resources have the same subject* [MeasureReport](measurereport.html): The identity of a patient to search for individual measure report results for* [MedicationAdministration](medicationadministration.html): The identity of a patient to list administrations for* [MedicationDispense](medicationdispense.html): The identity of a patient to list dispenses for* [MedicationRequest](medicationrequest.html): Returns prescriptions for a specific patient* [MedicationStatement](medicationstatement.html): Returns statements for a specific patient.* [MolecularSequence](molecularsequence.html): The subject that the sequence is about* [NutritionIntake](nutritionintake.html): Returns statements for a specific patient.* [NutritionOrder](nutritionorder.html): The identity of the individual or set of individuals who requires the diet, formula or nutritional supplement* [Observation](observation.html): The subject that the observation is about (if patient)* [Person](person.html): The Person links to this Patient* [Procedure](procedure.html): Search by subject - a patient* [Provenance](provenance.html): Where the activity involved patient data* [QuestionnaireResponse](questionnaireresponse.html): The patient that is the subject of the questionnaire response* [RelatedPerson](relatedperson.html): The patient this related person is related to* [RequestOrchestration](requestorchestration.html): The identity of a patient to search for request orchestrations* [ResearchSubject](researchsubject.html): Who or what is part of study* [RiskAssessment](riskassessment.html): Who/what does assessment apply to?* [ServiceRequest](servicerequest.html): Search by subject - a patient* [Specimen](specimen.html): The patient the specimen comes from* [SupplyDelivery](supplydelivery.html): Patient for whom the item is supplied* [SupplyRequest](supplyrequest.html): The patient or subject for whom the supply is destined* [Task](task.html): Search by patient* [VisionPrescription](visionprescription.html): The identity of a patient to list dispenses for") 212 @OptionalParam(name="patient", targetTypes={ } ) 213 ReferenceAndListParam thePatient, 214 215 216 @Description(shortDefinition="Time of service that is being documented") 217 @OptionalParam(name="period") 218 DateRangeParam thePeriod, 219 220 221 @Description(shortDefinition="Target of the relationship") 222 @OptionalParam(name="relatesto", targetTypes={ } ) 223 ReferenceAndListParam theRelatesto, 224 225 226 @Description(shortDefinition="replaces | transforms | signs | appends") 227 @OptionalParam(name="relation") 228 TokenAndListParam theRelation, 229 230 231 @Description(shortDefinition="Combination of relation and relatesTo") 232 @OptionalParam(name="relationship", compositeTypes= { ReferenceParam.class, TokenParam.class }) 233 CompositeAndListParam<ReferenceParam, TokenParam> theRelationship, 234 235 236 @Description(shortDefinition="Document security-tags") 237 @OptionalParam(name="security-label") 238 TokenAndListParam theSecurity_label, 239 240 241 @Description(shortDefinition="Additional details about where the content was created (e.g. clinical specialty)") 242 @OptionalParam(name="setting") 243 TokenAndListParam theSetting, 244 245 246 @Description(shortDefinition="current | superseded | entered-in-error") 247 @OptionalParam(name="status") 248 TokenAndListParam theStatus, 249 250 251 @Description(shortDefinition="Who/what is the subject of the document") 252 @OptionalParam(name="subject", targetTypes={ } ) 253 ReferenceAndListParam theSubject, 254 255 256 @Description(shortDefinition="Multiple Resources: * [Account](account.html): E.g. patient, expense, depreciation* [AllergyIntolerance](allergyintolerance.html): allergy | intolerance - Underlying mechanism (if known)* [Composition](composition.html): Kind of composition (LOINC if possible)* [Coverage](coverage.html): The kind of coverage (health plan, auto, Workers Compensation)* [DocumentReference](documentreference.html): Kind of document (LOINC if possible)* [Encounter](encounter.html): Specific type of encounter* [EpisodeOfCare](episodeofcare.html): Type/class - e.g. specialist referral, disease management* [Invoice](invoice.html): Type of Invoice* [MedicationDispense](medicationdispense.html): Returns dispenses of a specific type* [MolecularSequence](molecularsequence.html): Amino Acid Sequence/ DNA Sequence / RNA Sequence* [Specimen](specimen.html): The specimen type") 257 @OptionalParam(name="type") 258 TokenAndListParam theType, 259 260 261 @Description(shortDefinition="The business version identifier") 262 @OptionalParam(name="version") 263 StringAndListParam theVersion, 264 265 @RawParam 266 Map<String, List<String>> theAdditionalRawParams, 267 268 269 @IncludeParam 270 Set<Include> theIncludes, 271 272 @IncludeParam(reverse=true) 273 Set<Include> theRevIncludes, 274 275 @Sort 276 SortSpec theSort, 277 278 @ca.uhn.fhir.rest.annotation.Count 279 Integer theCount, 280 281 @ca.uhn.fhir.rest.annotation.Offset 282 Integer theOffset, 283 284 SummaryEnum theSummaryMode, 285 286 SearchTotalModeEnum theSearchTotalMode, 287 288 SearchContainedModeEnum theSearchContainedMode 289 290 ) { 291 startRequest(theServletRequest); 292 try { 293 SearchParameterMap paramMap = new SearchParameterMap(); 294 paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_FILTER, theFtFilter); 295 paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_CONTENT, theFtContent); 296 paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_TEXT, theFtText); 297 paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_SOURCE, theSearchForSource); 298 paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_LIST, theList); 299 paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_LANGUAGE, theResourceLanguage); 300 301 paramMap.add("_has", theHas); 302 paramMap.add("_id", the_id); 303 paramMap.add("_profile", the_profile); 304 paramMap.add("_security", the_security); 305 paramMap.add("_tag", the_tag); 306 paramMap.add("_text", the_text); 307 paramMap.add("attester", theAttester); 308 paramMap.add("author", theAuthor); 309 paramMap.add("based-on", theBased_on); 310 paramMap.add("bodysite", theBodysite); 311 paramMap.add("bodysite-reference", theBodysite_reference); 312 paramMap.add("category", theCategory); 313 paramMap.add("contenttype", theContenttype); 314 paramMap.add("context", theContext); 315 paramMap.add("creation", theCreation); 316 paramMap.add("custodian", theCustodian); 317 paramMap.add("date", theDate); 318 paramMap.add("description", theDescription); 319 paramMap.add("doc-status", theDoc_status); 320 paramMap.add("event-code", theEvent_code); 321 paramMap.add("event-reference", theEvent_reference); 322 paramMap.add("facility", theFacility); 323 paramMap.add("format-canonical", theFormat_canonical); 324 paramMap.add("format-code", theFormat_code); 325 paramMap.add("format-uri", theFormat_uri); 326 paramMap.add("identifier", theIdentifier); 327 paramMap.add("language", theLanguage); 328 paramMap.add("location", theLocation); 329 paramMap.add("modality", theModality); 330 paramMap.add("patient", thePatient); 331 paramMap.add("period", thePeriod); 332 paramMap.add("relatesto", theRelatesto); 333 paramMap.add("relation", theRelation); 334 paramMap.add("relationship", theRelationship); 335 paramMap.add("security-label", theSecurity_label); 336 paramMap.add("setting", theSetting); 337 paramMap.add("status", theStatus); 338 paramMap.add("subject", theSubject); 339 paramMap.add("type", theType); 340 paramMap.add("version", theVersion); 341paramMap.setRevIncludes(theRevIncludes); 342 paramMap.setLastUpdated(the_lastUpdated); 343 paramMap.setIncludes(theIncludes); 344 paramMap.setSort(theSort); 345 paramMap.setCount(theCount); 346 paramMap.setOffset(theOffset); 347 paramMap.setSummaryMode(theSummaryMode); 348 paramMap.setSearchTotalMode(theSearchTotalMode); 349 paramMap.setSearchContainedMode(theSearchContainedMode); 350 351 getDao().translateRawParameters(theAdditionalRawParams, paramMap); 352 353 ca.uhn.fhir.rest.api.server.IBundleProvider retVal = getDao().search(paramMap, theRequestDetails, theServletResponse); 354 return retVal; 355 } finally { 356 endRequest(theServletRequest); 357 } 358 } 359 360}