Mercurial > hg > orthanc-java
annotate JavaSDK/be/uclouvain/orthanc/FindMatcher.java @ 21:4ff1471ebe8b
added Samples/FHIR/configuration.json
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Fri, 05 Jan 2024 17:36:06 +0100 |
parents | 15dc698243ac |
children |
rev | line source |
---|---|
0 | 1 package be.uclouvain.orthanc; |
2 | |
3 /** | |
18 | 4 * SPDX-FileCopyrightText: 2023-2024 Sebastien Jodogne, UCLouvain, Belgium |
0 | 5 * SPDX-License-Identifier: GPL-3.0-or-later |
6 */ | |
7 | |
8 /** | |
9 * Java plugin for Orthanc | |
18 | 10 * Copyright (C) 2023-2024 Sebastien Jodogne, UCLouvain, Belgium |
0 | 11 * |
12 * This program is free software: you can redistribute it and/or | |
13 * modify it under the terms of the GNU General Public License as | |
14 * published by the Free Software Foundation, either version 3 of the | |
15 * License, or (at your option) any later version. | |
16 * | |
17 * This program is distributed in the hope that it will be useful, but | |
18 * WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
20 * General Public License for more details. | |
21 * | |
22 * You should have received a copy of the GNU General Public License | |
23 * along with this program. If not, see http://www.gnu.org/licenses/. | |
24 **/ | |
25 | |
26 | |
8
26c08ff926a3
added warning about auto-generated files
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
0
diff
changeset
|
27 // WARNING: Auto-generated file. Do not modify it by hand. |
26c08ff926a3
added warning about auto-generated files
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
0
diff
changeset
|
28 |
0 | 29 /** |
30 * Matcher for DICOM C-FIND query | |
31 **/ | |
32 public class FindMatcher { | |
33 private long self; | |
34 | |
35 /** | |
36 * Construct a Java object wrapping a C object that is managed by Orthanc. | |
37 * @param self Pointer to the C object. | |
38 **/ | |
39 protected FindMatcher(long self) { | |
40 if (self == 0) { | |
41 throw new IllegalArgumentException("Null pointer"); | |
42 } else { | |
43 this.self = self; | |
44 } | |
45 } | |
46 | |
47 /** | |
48 * Return the C object that is associated with this Java wrapper. | |
49 * @return Pointer to the C object. | |
50 **/ | |
51 protected long getSelf() { | |
52 return self; | |
53 } | |
54 | |
55 @Override | |
56 protected void finalize() throws Throwable { | |
57 dispose(); | |
58 super.finalize(); | |
59 } | |
60 | |
61 /** | |
62 * Manually deallocate the C object that is associated with this Java wrapper. | |
63 * | |
64 * This method can be used to immediately deallocate the C object, | |
65 * instead of waiting for the garbage collector to dispose the Java wrapper. | |
66 **/ | |
67 public void dispose() { | |
68 if (self != 0) { | |
69 NativeSDK.OrthancPluginFreeFindMatcher(self); | |
70 self = 0; | |
71 } | |
72 } | |
73 | |
74 /** | |
75 * Create a C-Find matcher. | |
76 * | |
77 * This function creates a "matcher" object that can be used to check whether a | |
78 * DICOM instance matches a C-Find query. The C-Find query must be expressed as a | |
79 * DICOM buffer. | |
80 * | |
81 * @param query The C-Find DICOM query. | |
82 * @return The newly constructed object. | |
83 **/ | |
84 public static FindMatcher createFindMatcher( | |
85 byte[] query) { | |
86 return new FindMatcher(NativeSDK.OrthancPluginCreateFindMatcher(query)); | |
87 } | |
88 | |
89 | |
90 /** | |
91 * Test whether a DICOM instance matches a C-Find query. | |
92 * | |
93 * This function checks whether one DICOM instance matches C-Find matcher that was | |
94 * previously allocated using OrthancPluginCreateFindMatcher(). | |
95 * | |
96 * @param dicom The DICOM instance to be matched. | |
97 * @return 1 if the DICOM instance matches the query, 0 otherwise. | |
98 **/ | |
99 public int findMatcherIsMatch( | |
100 byte[] dicom) { | |
101 return NativeSDK.OrthancPluginFindMatcherIsMatch(self, dicom); | |
102 } | |
103 | |
104 } |