001
002package ca.uhn.fhir.jpa.rp.r4b;
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.r4b.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                        @Description(shortDefinition="Search for resources which have the given tag")
048                        @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_TAG)
049                        TokenAndListParam theSearchForTag, 
050
051                        @Description(shortDefinition="Search for resources which have the given security labels")
052                        @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_SECURITY)
053                        TokenAndListParam theSearchForSecurity, 
054  
055                        @Description(shortDefinition="Search for resources which have the given profile")
056                        @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_PROFILE)
057                        UriAndListParam theSearchForProfile,
058
059                        @Description(shortDefinition="Search the contents of the resource's data using a list")
060                        @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_LIST)
061                        StringAndListParam theList,
062
063                        @Description(shortDefinition="The language of the resource")
064                        @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_LANGUAGE)
065                        TokenAndListParam theResourceLanguage,
066
067                        @Description(shortDefinition="Search for resources which have the given source value (Resource.meta.source)")
068                        @OptionalParam(name=ca.uhn.fhir.rest.api.Constants.PARAM_SOURCE)
069                        UriAndListParam theSearchForSource,
070
071                        @Description(shortDefinition="Return resources linked to by the given target")
072                        @OptionalParam(name="_has")
073                        HasAndListParam theHas, 
074
075   
076
077                        @Description(shortDefinition="The ID of the resource")
078                        @OptionalParam(name="_id")
079                        TokenAndListParam the_id,
080   
081
082                        @Description(shortDefinition="Search on the narrative of the resource")
083                        @OptionalParam(name="_text")
084                        StringAndListParam the_text, 
085   
086
087                        @Description(shortDefinition="Who/what authenticated the document")
088                        @OptionalParam(name="authenticator", targetTypes={  } )
089                        ReferenceAndListParam theAuthenticator, 
090   
091
092                        @Description(shortDefinition="Who and/or what authored the document")
093                        @OptionalParam(name="author", targetTypes={  } )
094                        ReferenceAndListParam theAuthor, 
095   
096
097                        @Description(shortDefinition="Categorization of document")
098                        @OptionalParam(name="category")
099                        TokenAndListParam theCategory,
100   
101
102                        @Description(shortDefinition="Mime type of the content, with charset etc.")
103                        @OptionalParam(name="contenttype")
104                        TokenAndListParam theContenttype,
105   
106
107                        @Description(shortDefinition="Organization which maintains the document")
108                        @OptionalParam(name="custodian", targetTypes={  } )
109                        ReferenceAndListParam theCustodian, 
110   
111
112                        @Description(shortDefinition="When this document reference was created")
113                        @OptionalParam(name="date")
114                        DateRangeParam theDate, 
115   
116
117                        @Description(shortDefinition="Human-readable description")
118                        @OptionalParam(name="description")
119                        StringAndListParam theDescription, 
120   
121
122                        @Description(shortDefinition="Multiple Resources: * [Composition](composition.html): Context of the Composition* [DeviceRequest](devicerequest.html): Encounter during which request was created* [DiagnosticReport](diagnosticreport.html): The Encounter when the order was made* [DocumentReference](documentreference.html): Context of the document  content* [Flag](flag.html): Alert relevant during encounter* [List](list.html): Context in which list created* [NutritionOrder](nutritionorder.html): Return nutrition orders with this encounter identifier* [Observation](observation.html): Encounter related to the observation* [Procedure](procedure.html): Encounter created as part of* [RiskAssessment](riskassessment.html): Where was assessment performed?* [ServiceRequest](servicerequest.html): An encounter in which this request is made* [VisionPrescription](visionprescription.html): Return prescriptions with this encounter identifier")
123                        @OptionalParam(name="encounter", targetTypes={  } )
124                        ReferenceAndListParam theEncounter, 
125   
126
127                        @Description(shortDefinition="Main clinical acts documented")
128                        @OptionalParam(name="event")
129                        TokenAndListParam theEvent,
130   
131
132                        @Description(shortDefinition="Kind of facility where patient was seen")
133                        @OptionalParam(name="facility")
134                        TokenAndListParam theFacility,
135   
136
137                        @Description(shortDefinition="Format/content rules for the document")
138                        @OptionalParam(name="format")
139                        TokenAndListParam theFormat,
140   
141
142                        @Description(shortDefinition="Multiple Resources: * [AllergyIntolerance](allergyintolerance.html): External ids for this item* [CarePlan](careplan.html): External Ids for this plan* [CareTeam](careteam.html): External Ids for this team* [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)* [DetectedIssue](detectedissue.html): Unique id for the detected issue* [DeviceRequest](devicerequest.html): Business identifier for request/order* [DiagnosticReport](diagnosticreport.html): An identifier for the report* [DocumentManifest](documentmanifest.html): Unique Identifier for the set of documents* [DocumentReference](documentreference.html): Master Version Specific Identifier* [Encounter](encounter.html): Identifier(s) by which this encounter is known* [EpisodeOfCare](episodeofcare.html): Business Identifier(s) relevant for this EpisodeOfCare* [FamilyMemberHistory](familymemberhistory.html): A search by a record identifier* [Goal](goal.html): External Ids for this goal* [ImagingStudy](imagingstudy.html): Identifiers for the Study, such as DICOM Study Instance UID and Accession number* [Immunization](immunization.html): Business identifier* [List](list.html): Business 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* [NutritionOrder](nutritionorder.html): Return nutrition orders with this external identifier* [Observation](observation.html): The unique id for a particular observation* [Procedure](procedure.html): A unique identifier for a procedure* [RiskAssessment](riskassessment.html): Unique identifier for the assessment* [ServiceRequest](servicerequest.html): Identifiers assigned to this order* [SupplyDelivery](supplydelivery.html): External identifier* [SupplyRequest](supplyrequest.html): Business Identifier for SupplyRequest* [VisionPrescription](visionprescription.html): Return prescriptions with this external identifier")
143                        @OptionalParam(name="identifier")
144                        TokenAndListParam theIdentifier,
145   
146
147                        @Description(shortDefinition="Human language of the content (BCP-47)")
148                        @OptionalParam(name="language")
149                        TokenAndListParam theLanguage,
150   
151
152                        @Description(shortDefinition="Uri where the data can be found")
153                        @OptionalParam(name="location")
154                        UriAndListParam theLocation, 
155   
156
157                        @Description(shortDefinition="Multiple Resources: * [AllergyIntolerance](allergyintolerance.html): Who the sensitivity is for* [CarePlan](careplan.html): Who the care plan is for* [CareTeam](careteam.html): Who care team is for* [ClinicalImpression](clinicalimpression.html): Patient or group assessed* [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* [DetectedIssue](detectedissue.html): Associated patient* [DeviceRequest](devicerequest.html): Individual the service is ordered for* [DeviceUseStatement](deviceusestatement.html): Search by subject - a patient* [DiagnosticReport](diagnosticreport.html): The subject of the report if a patient* [DocumentManifest](documentmanifest.html): The subject of the set of documents* [DocumentReference](documentreference.html): Who/what is the subject of the document* [Encounter](encounter.html): The patient or group present at the encounter* [EpisodeOfCare](episodeofcare.html): The patient who is the focus of this episode of care* [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* [ImagingStudy](imagingstudy.html): Who the study is about* [Immunization](immunization.html): The patient for the vaccination record* [List](list.html): If all resources have the same subject* [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.* [NutritionOrder](nutritionorder.html): The identity of the person who requires the diet, formula or nutritional supplement* [Observation](observation.html): The subject that the observation is about (if patient)* [Procedure](procedure.html): Search by subject - a patient* [RiskAssessment](riskassessment.html): Who/what does assessment apply to?* [ServiceRequest](servicerequest.html): Search by subject - a patient* [SupplyDelivery](supplydelivery.html): Patient for whom the item is supplied* [VisionPrescription](visionprescription.html): The identity of a patient to list dispenses for")
158                        @OptionalParam(name="patient", targetTypes={  } )
159                        ReferenceAndListParam thePatient, 
160   
161
162                        @Description(shortDefinition="Time of service that is being documented")
163                        @OptionalParam(name="period")
164                        DateRangeParam thePeriod, 
165   
166
167                        @Description(shortDefinition="Related identifiers or resources")
168                        @OptionalParam(name="related", targetTypes={  } )
169                        ReferenceAndListParam theRelated, 
170   
171
172                        @Description(shortDefinition="Target of the relationship")
173                        @OptionalParam(name="relatesto", targetTypes={  } )
174                        ReferenceAndListParam theRelatesto, 
175   
176
177                        @Description(shortDefinition="replaces | transforms | signs | appends")
178                        @OptionalParam(name="relation")
179                        TokenAndListParam theRelation,
180   
181
182                        @Description(shortDefinition="Combination of relation and relatesTo")
183                        @OptionalParam(name="relationship", compositeTypes= { ReferenceParam.class, TokenParam.class })
184                        CompositeAndListParam<ReferenceParam, TokenParam> theRelationship,
185   
186
187                        @Description(shortDefinition="Document security-tags")
188                        @OptionalParam(name="security-label")
189                        TokenAndListParam theSecurity_label,
190   
191
192                        @Description(shortDefinition="Additional details about where the content was created (e.g. clinical specialty)")
193                        @OptionalParam(name="setting")
194                        TokenAndListParam theSetting,
195   
196
197                        @Description(shortDefinition="current | superseded | entered-in-error")
198                        @OptionalParam(name="status")
199                        TokenAndListParam theStatus,
200   
201
202                        @Description(shortDefinition="Who/what is the subject of the document")
203                        @OptionalParam(name="subject", targetTypes={  } )
204                        ReferenceAndListParam theSubject, 
205   
206
207                        @Description(shortDefinition="Multiple Resources: * [AllergyIntolerance](allergyintolerance.html): allergy | intolerance - Underlying mechanism (if known)* [Composition](composition.html): Kind of composition (LOINC if possible)* [DocumentManifest](documentmanifest.html): Kind of document set* [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")
208                        @OptionalParam(name="type")
209                        TokenAndListParam theType,
210
211                        @RawParam
212                        Map<String, List<String>> theAdditionalRawParams,
213
214                        @Description(shortDefinition="Only return resources which were last updated as specified by the given range")
215                        @OptionalParam(name="_lastUpdated")
216                        DateRangeParam theLastUpdated, 
217
218                        @IncludeParam
219                        Set<Include> theIncludes,
220
221                        @IncludeParam(reverse=true)
222                        Set<Include> theRevIncludes,
223
224                        @Sort
225                        SortSpec theSort,
226                        
227                        @ca.uhn.fhir.rest.annotation.Count
228                        Integer theCount,
229
230                        @ca.uhn.fhir.rest.annotation.Offset
231                        Integer theOffset,
232
233                        SummaryEnum theSummaryMode,
234
235                        SearchTotalModeEnum theSearchTotalMode,
236
237                        SearchContainedModeEnum theSearchContainedMode
238
239                        ) {
240                startRequest(theServletRequest);
241                try {
242                        SearchParameterMap paramMap = new SearchParameterMap();
243                        paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_FILTER, theFtFilter);
244                        paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_CONTENT, theFtContent);
245                        paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_TEXT, theFtText);
246                        paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_TAG, theSearchForTag);
247                        paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_SECURITY, theSearchForSecurity);
248                        paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_PROFILE, theSearchForProfile);
249                        paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_SOURCE, theSearchForSource);
250                        paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_LIST, theList);
251                        paramMap.add(ca.uhn.fhir.rest.api.Constants.PARAM_LANGUAGE, theResourceLanguage);
252
253                        paramMap.add("_has", theHas);
254                        paramMap.add("_id", the_id);
255                        paramMap.add("_text", the_text);
256                        paramMap.add("authenticator", theAuthenticator);
257                        paramMap.add("author", theAuthor);
258                        paramMap.add("category", theCategory);
259                        paramMap.add("contenttype", theContenttype);
260                        paramMap.add("custodian", theCustodian);
261                        paramMap.add("date", theDate);
262                        paramMap.add("description", theDescription);
263                        paramMap.add("encounter", theEncounter);
264                        paramMap.add("event", theEvent);
265                        paramMap.add("facility", theFacility);
266                        paramMap.add("format", theFormat);
267                        paramMap.add("identifier", theIdentifier);
268                        paramMap.add("language", theLanguage);
269                        paramMap.add("location", theLocation);
270                        paramMap.add("patient", thePatient);
271                        paramMap.add("period", thePeriod);
272                        paramMap.add("related", theRelated);
273                        paramMap.add("relatesto", theRelatesto);
274                        paramMap.add("relation", theRelation);
275                        paramMap.add("relationship", theRelationship);
276                        paramMap.add("security-label", theSecurity_label);
277                        paramMap.add("setting", theSetting);
278                        paramMap.add("status", theStatus);
279                        paramMap.add("subject", theSubject);
280                        paramMap.add("type", theType);
281                        paramMap.setRevIncludes(theRevIncludes);
282                        paramMap.setLastUpdated(theLastUpdated);
283                        paramMap.setIncludes(theIncludes);
284                        paramMap.setSort(theSort);
285                        paramMap.setCount(theCount);
286                        paramMap.setOffset(theOffset);
287                        paramMap.setSummaryMode(theSummaryMode);
288                        paramMap.setSearchTotalMode(theSearchTotalMode);
289                        paramMap.setSearchContainedMode(theSearchContainedMode);
290
291                        getDao().translateRawParameters(theAdditionalRawParams, paramMap);
292
293                        ca.uhn.fhir.rest.api.server.IBundleProvider retVal = getDao().search(paramMap, theRequestDetails, theServletResponse);
294                        return retVal;
295                } finally {
296                        endRequest(theServletRequest);
297                }
298        }
299
300}