Mercurial > hg > orthanc-java
diff JavaSDK/be/uclouvain/orthanc/FindMatcher.java @ 0:3ecef5782f2c
initial commit
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Wed, 18 Oct 2023 17:59:44 +0200 |
parents | |
children | 26c08ff926a3 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/JavaSDK/be/uclouvain/orthanc/FindMatcher.java Wed Oct 18 17:59:44 2023 +0200 @@ -0,0 +1,102 @@ +package be.uclouvain.orthanc; + +/** + * SPDX-FileCopyrightText: 2023 Sebastien Jodogne, UCLouvain, Belgium + * SPDX-License-Identifier: GPL-3.0-or-later + */ + +/** + * Java plugin for Orthanc + * Copyright (C) 2023 Sebastien Jodogne, UCLouvain, Belgium + * + * This program is free software: you can redistribute it and/or + * modify it under the terms of the GNU General Public License as + * published by the Free Software Foundation, either version 3 of the + * License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, but + * WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see http://www.gnu.org/licenses/. + **/ + + +/** + * Matcher for DICOM C-FIND query + **/ +public class FindMatcher { + private long self; + + /** + * Construct a Java object wrapping a C object that is managed by Orthanc. + * @param self Pointer to the C object. + **/ + protected FindMatcher(long self) { + if (self == 0) { + throw new IllegalArgumentException("Null pointer"); + } else { + this.self = self; + } + } + + /** + * Return the C object that is associated with this Java wrapper. + * @return Pointer to the C object. + **/ + protected long getSelf() { + return self; + } + + @Override + protected void finalize() throws Throwable { + dispose(); + super.finalize(); + } + + /** + * Manually deallocate the C object that is associated with this Java wrapper. + * + * This method can be used to immediately deallocate the C object, + * instead of waiting for the garbage collector to dispose the Java wrapper. + **/ + public void dispose() { + if (self != 0) { + NativeSDK.OrthancPluginFreeFindMatcher(self); + self = 0; + } + } + + /** + * Create a C-Find matcher. + * + * This function creates a "matcher" object that can be used to check whether a + * DICOM instance matches a C-Find query. The C-Find query must be expressed as a + * DICOM buffer. + * + * @param query The C-Find DICOM query. + * @return The newly constructed object. + **/ + public static FindMatcher createFindMatcher( + byte[] query) { + return new FindMatcher(NativeSDK.OrthancPluginCreateFindMatcher(query)); + } + + + /** + * Test whether a DICOM instance matches a C-Find query. + * + * This function checks whether one DICOM instance matches C-Find matcher that was + * previously allocated using OrthancPluginCreateFindMatcher(). + * + * @param dicom The DICOM instance to be matched. + * @return 1 if the DICOM instance matches the query, 0 otherwise. + **/ + public int findMatcherIsMatch( + byte[] dicom) { + return NativeSDK.OrthancPluginFindMatcherIsMatch(self, dicom); + } + +}