Java tutorial
package mod.org.dcm4che2.tool; /* ***** BEGIN LICENSE BLOCK ***** * Version: MPL 1.1/GPL 2.0/LGPL 2.1 * * The contents of this file are subject to the Mozilla Public License Version * 1.1 (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * http://www.mozilla.org/MPL/ * * Software distributed under the License is distributed on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License * for the specific language governing rights and limitations under the * License. * * The Original Code is part of dcm4che, an implementation of DICOM(TM) in * Java(TM), hosted at http://sourceforge.net/projects/dcm4che. * * The Initial Developer of the Original Code is * Gunter Zeilinger, Huetteldorferstr. 24/10, 1150 Vienna/Austria/Europe. * Portions created by the Initial Developer are Copyright (C) 2002-2005 * the Initial Developer. All Rights Reserved. * * Contributor(s): * Gunter Zeilinger <gunterze@gmail.com> * * Alternatively, the contents of this file may be used under the terms of * either the GNU General Public License Version 2 or later (the "GPL"), or * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"), * in which case the provisions of the GPL or the LGPL are applicable instead * of those above. If you wish to allow use of your version of this file only * under the terms of either the GPL or the LGPL, and not to allow others to * use your version of this file under the terms of the MPL, indicate your * decision by deleting the provisions above and replace them with the notice * and other provisions required by the GPL or the LGPL. If you do not delete * the provisions above, a recipient may use your version of this file under * the terms of any one of the MPL, the GPL or the LGPL. * * ***** END LICENSE BLOCK ***** */ import java.io.BufferedOutputStream; import java.io.File; import java.io.FileInputStream; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStream; import java.net.MalformedURLException; import java.net.URL; import java.security.GeneralSecurityException; import java.security.KeyStore; import java.util.ArrayList; import java.util.Arrays; import java.util.Collections; import java.util.List; import java.util.concurrent.Executor; import org.apache.commons.cli.CommandLine; import org.apache.commons.cli.GnuParser; import org.apache.commons.cli.HelpFormatter; import org.apache.commons.cli.Option; import org.apache.commons.cli.OptionBuilder; import org.apache.commons.cli.OptionGroup; import org.apache.commons.cli.Options; import org.apache.commons.cli.ParseException; import org.dcm4che2.data.BasicDicomObject; import org.dcm4che2.data.DicomObject; import org.dcm4che2.data.Tag; import org.dcm4che2.data.UID; import org.dcm4che2.data.UIDDictionary; import org.dcm4che2.data.VR; import org.dcm4che2.io.DicomOutputStream; import org.dcm4che2.net.Association; import org.dcm4che2.net.CommandUtils; import org.dcm4che2.net.ConfigurationException; import org.dcm4che2.net.Device; import org.dcm4che2.net.DicomServiceException; import org.dcm4che2.net.DimseRSP; import org.dcm4che2.net.DimseRSPHandler; import org.dcm4che2.net.ExtQueryTransferCapability; import org.dcm4che2.net.ExtRetrieveTransferCapability; import org.dcm4che2.net.NetworkApplicationEntity; import org.dcm4che2.net.NetworkConnection; import org.dcm4che2.net.NewThreadExecutor; import org.dcm4che2.net.NoPresentationContextException; import org.dcm4che2.net.PDVInputStream; import org.dcm4che2.net.Status; import org.dcm4che2.net.TransferCapability; import org.dcm4che2.net.UserIdentity; import org.dcm4che2.net.service.DicomService; import org.dcm4che2.net.service.StorageService; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * @author gunter zeilinger(gunterze@gmail.com) * @version $Revision: 14908 $ $Date: 2011-02-16 14:57:03 +0100 (Wed, 16 Feb 2011) $ * @since Jan, 2006 */ public class DcmQR { private static final Logger LOG = LoggerFactory.getLogger(DcmQR.class); private static final int KB = 1024; private static final String USAGE = "dcmqr <aet>[@<host>[:<port>]] [Options]"; private static final String DESCRIPTION = "Query specified remote Application Entity (=Query/Retrieve SCP) " + "and optional (s. option -cget/-cmove) retrieve instances of " + "matching entities. If <port> is not specified, DICOM default port " + "104 is assumed. If also no <host> is specified localhost is assumed. " + "Also Storage Services can be provided (s. option -cstore) to receive " + "retrieved instances. For receiving objects retrieved by C-MOVE in a " + "separate association, a local listening port must be specified " + "(s.option -L).\n" + "Options:"; private static final String EXAMPLE = "\nExample: dcmqr -L QRSCU:11113 QRSCP@localhost:11112 -cmove QRSCU " + "-qStudyDate=20060204 -qModalitiesInStudy=CT -cstore CT -cstore PR:LE " + "-cstoredest /tmp\n" + "=> Query Application Entity QRSCP listening on local port 11112 for " + "CT studies from Feb 4, 2006 and retrieve matching studies by C-MOVE " + "to own Application Entity QRSCU listing on local port 11113, " + "storing received CT images and Grayscale Softcopy Presentation " + "states to /tmp."; private static String[] TLS1 = { "TLSv1" }; private static String[] SSL3 = { "SSLv3" }; private static String[] NO_TLS1 = { "SSLv3", "SSLv2Hello" }; private static String[] NO_SSL2 = { "TLSv1", "SSLv3" }; private static String[] NO_SSL3 = { "TLSv1", "SSLv2Hello" }; private static char[] SECRET = { 's', 'e', 'c', 'r', 'e', 't' }; public static enum QueryRetrieveLevel { PATIENT("PATIENT", PATIENT_RETURN_KEYS, PATIENT_LEVEL_FIND_CUID, PATIENT_LEVEL_GET_CUID, PATIENT_LEVEL_MOVE_CUID), STUDY("STUDY", STUDY_RETURN_KEYS, STUDY_LEVEL_FIND_CUID, STUDY_LEVEL_GET_CUID, STUDY_LEVEL_MOVE_CUID), SERIES("SERIES", SERIES_RETURN_KEYS, SERIES_LEVEL_FIND_CUID, SERIES_LEVEL_GET_CUID, SERIES_LEVEL_MOVE_CUID), IMAGE("IMAGE", INSTANCE_RETURN_KEYS, SERIES_LEVEL_FIND_CUID, SERIES_LEVEL_GET_CUID, SERIES_LEVEL_MOVE_CUID); private final String code; private final int[] returnKeys; private final String[] findClassUids; private final String[] getClassUids; private final String[] moveClassUids; private QueryRetrieveLevel(String code, int[] returnKeys, String[] findClassUids, String[] getClassUids, String[] moveClassUids) { this.code = code; this.returnKeys = returnKeys; this.findClassUids = findClassUids; this.getClassUids = getClassUids; this.moveClassUids = moveClassUids; } public String getCode() { return this.code; } public int[] getReturnKeys() { return this.returnKeys; } public String[] getFindClassUids() { return this.findClassUids; } public String[] getGetClassUids() { return this.getClassUids; } public String[] getMoveClassUids() { return this.moveClassUids; } } static final String[] PATIENT_LEVEL_FIND_CUID = { UID.PatientRootQueryRetrieveInformationModelFIND, UID.PatientStudyOnlyQueryRetrieveInformationModelFINDRetired }; static final String[] STUDY_LEVEL_FIND_CUID = { UID.StudyRootQueryRetrieveInformationModelFIND, UID.PatientRootQueryRetrieveInformationModelFIND, UID.PatientStudyOnlyQueryRetrieveInformationModelFINDRetired }; static final String[] SERIES_LEVEL_FIND_CUID = { UID.StudyRootQueryRetrieveInformationModelFIND, UID.PatientRootQueryRetrieveInformationModelFIND, }; static final String[] PATIENT_LEVEL_GET_CUID = { UID.PatientRootQueryRetrieveInformationModelGET, UID.PatientStudyOnlyQueryRetrieveInformationModelGETRetired }; static final String[] STUDY_LEVEL_GET_CUID = { UID.StudyRootQueryRetrieveInformationModelGET, UID.PatientRootQueryRetrieveInformationModelGET, UID.PatientStudyOnlyQueryRetrieveInformationModelGETRetired }; static final String[] SERIES_LEVEL_GET_CUID = { UID.StudyRootQueryRetrieveInformationModelGET, UID.PatientRootQueryRetrieveInformationModelGET }; static final String[] PATIENT_LEVEL_MOVE_CUID = { UID.PatientRootQueryRetrieveInformationModelMOVE, UID.PatientStudyOnlyQueryRetrieveInformationModelMOVERetired }; static final String[] STUDY_LEVEL_MOVE_CUID = { UID.StudyRootQueryRetrieveInformationModelMOVE, UID.PatientRootQueryRetrieveInformationModelMOVE, UID.PatientStudyOnlyQueryRetrieveInformationModelMOVERetired }; static final String[] SERIES_LEVEL_MOVE_CUID = { UID.StudyRootQueryRetrieveInformationModelMOVE, UID.PatientRootQueryRetrieveInformationModelMOVE }; static final int[] PATIENT_RETURN_KEYS = { Tag.PatientName, Tag.PatientID, Tag.PatientBirthDate, Tag.PatientSex, Tag.NumberOfPatientRelatedStudies, Tag.NumberOfPatientRelatedSeries, Tag.NumberOfPatientRelatedInstances }; static final int[] PATIENT_MATCHING_KEYS = { Tag.PatientName, Tag.PatientID, Tag.IssuerOfPatientID, Tag.PatientBirthDate, Tag.PatientSex }; static final int[] STUDY_RETURN_KEYS = { Tag.StudyDate, Tag.StudyTime, Tag.AccessionNumber, Tag.StudyID, Tag.StudyInstanceUID, Tag.NumberOfStudyRelatedSeries, Tag.NumberOfStudyRelatedInstances }; static final int[] STUDY_MATCHING_KEYS = { Tag.StudyDate, Tag.StudyTime, Tag.AccessionNumber, Tag.ModalitiesInStudy, Tag.ReferringPhysicianName, Tag.StudyID, Tag.StudyInstanceUID }; static final int[] PATIENT_STUDY_MATCHING_KEYS = { Tag.StudyDate, Tag.StudyTime, Tag.AccessionNumber, Tag.ModalitiesInStudy, Tag.ReferringPhysicianName, Tag.PatientName, Tag.PatientID, Tag.IssuerOfPatientID, Tag.PatientBirthDate, Tag.PatientSex, Tag.StudyID, Tag.StudyInstanceUID }; static final int[] SERIES_RETURN_KEYS = { Tag.Modality, Tag.SeriesNumber, Tag.SeriesInstanceUID, Tag.NumberOfSeriesRelatedInstances }; static final int[] SERIES_MATCHING_KEYS = { Tag.Modality, Tag.SeriesNumber, Tag.SeriesInstanceUID, Tag.RequestAttributesSequence }; static final int[] INSTANCE_RETURN_KEYS = { Tag.InstanceNumber, Tag.SOPClassUID, Tag.SOPInstanceUID, }; static final int[] MOVE_KEYS = { Tag.QueryRetrieveLevel, Tag.PatientID, Tag.StudyInstanceUID, Tag.SeriesInstanceUID, Tag.SOPInstanceUID, }; static final String[] IVRLE_TS = { UID.ImplicitVRLittleEndian }; static final String[] NATIVE_LE_TS = { UID.ExplicitVRLittleEndian, UID.ImplicitVRLittleEndian }; static final String[] NATIVE_BE_TS = { UID.ExplicitVRBigEndian, UID.ImplicitVRLittleEndian }; static final String[] DEFLATED_TS = { UID.DeflatedExplicitVRLittleEndian, UID.ExplicitVRLittleEndian, UID.ImplicitVRLittleEndian }; static final String[] NOPX_TS = { UID.NoPixelData, UID.ExplicitVRLittleEndian, UID.ImplicitVRLittleEndian }; static final String[] NOPXDEFL_TS = { UID.NoPixelDataDeflate, UID.NoPixelData, UID.ExplicitVRLittleEndian, UID.ImplicitVRLittleEndian }; static final String[] JPLL_TS = { UID.JPEGLossless, UID.JPEGLosslessNonHierarchical14, UID.JPEGLSLossless, UID.JPEG2000LosslessOnly, UID.ExplicitVRLittleEndian, UID.ImplicitVRLittleEndian }; static final String[] JPLY_TS = { UID.JPEGBaseline1, UID.JPEGExtended24, UID.JPEGLSLossyNearLossless, UID.JPEG2000, UID.ExplicitVRLittleEndian, UID.ImplicitVRLittleEndian }; static final String[] MPEG2_TS = { UID.MPEG2 }; public static final String[] DEF_TS = { UID.JPEGLossless, UID.JPEGLosslessNonHierarchical14, UID.JPEGLSLossless, UID.JPEGLSLossyNearLossless, UID.JPEG2000LosslessOnly, UID.JPEG2000, UID.JPEGBaseline1, UID.JPEGExtended24, UID.MPEG2, UID.DeflatedExplicitVRLittleEndian, UID.ExplicitVRBigEndian, UID.ExplicitVRLittleEndian, UID.ImplicitVRLittleEndian }; public static enum TS { IVLE(IVRLE_TS), LE(NATIVE_LE_TS), BE(NATIVE_BE_TS), DEFL(DEFLATED_TS), JPLL(JPLL_TS), JPLY(JPLY_TS), MPEG2( MPEG2_TS), NOPX(NOPX_TS), NOPXD(NOPXDEFL_TS); public final String[] uids; TS(String[] uids) { this.uids = uids; } } public static enum CUID { CR(UID.ComputedRadiographyImageStorage), CT(UID.CTImageStorage), MR(UID.MRImageStorage), US( UID.UltrasoundImageStorage), NM(UID.NuclearMedicineImageStorage), PET( UID.PositronEmissionTomographyImageStorage), SC(UID.SecondaryCaptureImageStorage), XA( UID.XRayAngiographicImageStorage), XRF(UID.XRayRadiofluoroscopicImageStorage), DX( UID.DigitalXRayImageStorageForPresentation), MG( UID.DigitalMammographyXRayImageStorageForPresentation), PR( UID.GrayscaleSoftcopyPresentationStateStorageSOPClass), KO( UID.KeyObjectSelectionDocumentStorage), SR( UID.BasicTextSRStorage); public final String uid; CUID(String uid) { this.uid = uid; } } private static final String[] EMPTY_STRING = {}; private final Executor executor; private final NetworkApplicationEntity remoteAE = new NetworkApplicationEntity(); private final NetworkConnection remoteConn = new NetworkConnection(); private final Device device; private final NetworkApplicationEntity ae = new NetworkApplicationEntity(); private final NetworkConnection conn = new NetworkConnection(); private Association assoc; private int priority = 0; private boolean cfind; private boolean cget; private String moveDest; File storeDest; boolean devnull; int fileBufferSize = 256; private boolean evalRetrieveAET = false; private QueryRetrieveLevel qrlevel = QueryRetrieveLevel.STUDY; private List<String> privateFind = new ArrayList<>(); private final List<TransferCapability> storeTransferCapability = new ArrayList<>(8); private DicomObject keys = new BasicDicomObject(); private int cancelAfter = Integer.MAX_VALUE; private int completed; private int warning; private int failed; private boolean relationQR; private boolean dateTimeMatching; private boolean fuzzySemanticPersonNameMatching; private boolean noExtNegotiation; private String keyStoreURL = "resource:tls/test_sys_1.p12"; private char[] keyStorePassword = SECRET; private char[] keyPassword; private String trustStoreURL = "resource:tls/mesa_certs.jks"; private char[] trustStorePassword = SECRET; public DcmQR(String name) { this.device = new Device(name); this.executor = new NewThreadExecutor(name); this.remoteAE.setInstalled(true); this.remoteAE.setAssociationAcceptor(true); this.remoteAE.setNetworkConnection(new NetworkConnection[] { this.remoteConn }); this.device.setNetworkApplicationEntity(this.ae); this.device.setNetworkConnection(this.conn); this.ae.setNetworkConnection(this.conn); this.ae.setAssociationInitiator(true); this.ae.setAssociationAcceptor(true); this.ae.setAETitle(name); } public final void setLocalHost(String hostname) { this.conn.setHostname(hostname); } public final void setLocalPort(int port) { this.conn.setPort(port); } public final void setRemoteHost(String hostname) { this.remoteConn.setHostname(hostname); } public final void setRemotePort(int port) { this.remoteConn.setPort(port); } public final void setTlsProtocol(String[] tlsProtocol) { this.conn.setTlsProtocol(tlsProtocol); } public final void setTlsWithoutEncyrption() { this.conn.setTlsWithoutEncyrption(); this.remoteConn.setTlsWithoutEncyrption(); } public final void setTls3DES_EDE_CBC() { this.conn.setTls3DES_EDE_CBC(); this.remoteConn.setTls3DES_EDE_CBC(); } public final void setTlsAES_128_CBC() { this.conn.setTlsAES_128_CBC(); this.remoteConn.setTlsAES_128_CBC(); } public final void setTlsNeedClientAuth(boolean needClientAuth) { this.conn.setTlsNeedClientAuth(needClientAuth); } public final void setKeyStoreURL(String url) { this.keyStoreURL = url; } public final void setKeyStorePassword(String pw) { this.keyStorePassword = pw.toCharArray(); } public final void setKeyPassword(String pw) { this.keyPassword = pw.toCharArray(); } public final void setTrustStorePassword(String pw) { this.trustStorePassword = pw.toCharArray(); } public final void setTrustStoreURL(String url) { this.trustStoreURL = url; } public final void setCalledAET(String called, boolean reuse) { this.remoteAE.setAETitle(called); if (reuse) this.ae.setReuseAssocationToAETitle(new String[] { called }); } public final void setCalling(String calling) { this.ae.setAETitle(calling); } public final void setUserIdentity(UserIdentity userIdentity) { this.ae.setUserIdentity(userIdentity); } public final void setPriority(int priority) { this.priority = priority; } public final void setConnectTimeout(int connectTimeout) { this.conn.setConnectTimeout(connectTimeout); } public final void setMaxPDULengthReceive(int maxPDULength) { this.ae.setMaxPDULengthReceive(maxPDULength); } public final void setMaxOpsInvoked(int maxOpsInvoked) { this.ae.setMaxOpsInvoked(maxOpsInvoked); } public final void setMaxOpsPerformed(int maxOps) { this.ae.setMaxOpsPerformed(maxOps); } public final void setPackPDV(boolean packPDV) { this.ae.setPackPDV(packPDV); } public final void setAssociationReaperPeriod(int period) { this.device.setAssociationReaperPeriod(period); } public final void setDimseRspTimeout(int timeout) { this.ae.setDimseRspTimeout(timeout); } public final void setRetrieveRspTimeout(int timeout) { this.ae.setRetrieveRspTimeout(timeout); } public final void setTcpNoDelay(boolean tcpNoDelay) { this.conn.setTcpNoDelay(tcpNoDelay); } public final void setAcceptTimeout(int timeout) { this.conn.setAcceptTimeout(timeout); } public final void setReleaseTimeout(int timeout) { this.conn.setReleaseTimeout(timeout); } public final void setSocketCloseDelay(int timeout) { this.conn.setSocketCloseDelay(timeout); } public final void setMaxPDULengthSend(int maxPDULength) { this.ae.setMaxPDULengthSend(maxPDULength); } public final void setReceiveBufferSize(int bufferSize) { this.conn.setReceiveBufferSize(bufferSize); } public final void setSendBufferSize(int bufferSize) { this.conn.setSendBufferSize(bufferSize); } public final void setFileBufferSize(int size) { this.fileBufferSize = size; } private static CommandLine parse(String[] args) { Options opts = new Options(); OptionBuilder.withArgName("name"); OptionBuilder.hasArg(); OptionBuilder.withDescription("set device name, use DCMQR by default"); opts.addOption(OptionBuilder.create("device")); OptionBuilder.withArgName("aet[@host][:port]"); OptionBuilder.hasArg(); OptionBuilder.withDescription("set AET, local address and listening port of local" + "Application Entity, use device name and pick up any valid " + "local address to bind the socket by default"); opts.addOption(OptionBuilder.create("L")); OptionBuilder.withArgName("username"); OptionBuilder.hasArg(); OptionBuilder.withDescription( "enable User Identity Negotiation with specified username and " + " optional passcode"); opts.addOption(OptionBuilder.create("username")); OptionBuilder.withArgName("passcode"); OptionBuilder.hasArg(); OptionBuilder.withDescription( "optional passcode for User Identity Negotiation, " + "only effective with option -username"); opts.addOption(OptionBuilder.create("passcode")); opts.addOption("uidnegrsp", false, "request positive User Identity Negotation response, " + "only effective with option -username"); OptionBuilder.withArgName("NULL|3DES|AES"); OptionBuilder.hasArg(); OptionBuilder.withDescription("enable TLS connection without, 3DES or AES encryption"); opts.addOption(OptionBuilder.create("tls")); OptionGroup tlsProtocol = new OptionGroup(); tlsProtocol.addOption(new Option("tls1", "disable the use of SSLv3 and SSLv2 for TLS connections")); tlsProtocol.addOption(new Option("ssl3", "disable the use of TLSv1 and SSLv2 for TLS connections")); tlsProtocol.addOption(new Option("no_tls1", "disable the use of TLSv1 for TLS connections")); tlsProtocol.addOption(new Option("no_ssl3", "disable the use of SSLv3 for TLS connections")); tlsProtocol.addOption(new Option("no_ssl2", "disable the use of SSLv2 for TLS connections")); opts.addOptionGroup(tlsProtocol); opts.addOption("noclientauth", false, "disable client authentification for TLS"); OptionBuilder.withArgName("file|url"); OptionBuilder.hasArg(); OptionBuilder .withDescription("file path or URL of P12 or JKS keystore, resource:tls/test_sys_1.p12 by default"); opts.addOption(OptionBuilder.create("keystore")); OptionBuilder.withArgName("password"); OptionBuilder.hasArg(); OptionBuilder.withDescription("password for keystore file, 'secret' by default"); opts.addOption(OptionBuilder.create("keystorepw")); OptionBuilder.withArgName("password"); OptionBuilder.hasArg(); OptionBuilder .withDescription("password for accessing the key in the keystore, keystore password by default"); opts.addOption(OptionBuilder.create("keypw")); OptionBuilder.withArgName("file|url"); OptionBuilder.hasArg(); OptionBuilder.withDescription("file path or URL of JKS truststore, resource:tls/mesa_certs.jks by default"); opts.addOption(OptionBuilder.create("truststore")); OptionBuilder.withArgName("password"); OptionBuilder.hasArg(); OptionBuilder.withDescription("password for truststore file, 'secret' by default"); opts.addOption(OptionBuilder.create("truststorepw")); OptionBuilder.withArgName("aet"); OptionBuilder.hasArg(); OptionBuilder .withDescription("retrieve instances of matching entities by C-MOVE to specified destination."); opts.addOption(OptionBuilder.create("cmove")); opts.addOption("nocfind", false, "retrieve instances without previous query - unique keys must be specified by -q options"); opts.addOption("cget", false, "retrieve instances of matching entities by C-GET."); OptionBuilder.withArgName("cuid[:ts]"); OptionBuilder.hasArgs(); OptionBuilder.withDescription("negotiate support of specified Storage SOP Class and Transfer " + "Syntaxes. The Storage SOP Class may be specified by its UID " + "or by one of following key words:\n" + "CR - Computed Radiography Image Storage\n" + "CT - CT Image Storage\n" + "MR - MRImageStorage\n" + "US - Ultrasound Image Storage\n" + "NM - Nuclear Medicine Image Storage\n" + "PET - PET Image Storage\n" + "SC - Secondary Capture Image Storage\n" + "XA - XRay Angiographic Image Storage\n" + "XRF - XRay Radiofluoroscopic Image Storage\n" + "DX - Digital X-Ray Image Storage for Presentation\n" + "MG - Digital Mammography X-Ray Image Storage for Presentation\n" + "PR - Grayscale Softcopy Presentation State Storage\n" + "KO - Key Object Selection Document Storage\n" + "SR - Basic Text Structured Report Document Storage\n" + "The Transfer Syntaxes may be specified by a comma " + "separated list of UIDs or by one of following key " + "words:\n" + "IVRLE - offer only Implicit VR Little Endian " + "Transfer Syntax\n" + "LE - offer Explicit and Implicit VR Little Endian " + "Transfer Syntax\n" + "BE - offer Explicit VR Big Endian Transfer Syntax\n" + "DEFL - offer Deflated Explicit VR Little " + "Endian Transfer Syntax\n" + "JPLL - offer JEPG Loss Less Transfer Syntaxes\n" + "JPLY - offer JEPG Lossy Transfer Syntaxes\n" + "MPEG2 - offer MPEG2 Transfer Syntax\n" + "NOPX - offer No Pixel Data Transfer Syntax\n" + "NOPXD - offer No Pixel Data Deflate Transfer Syntax\n" + "If only the Storage SOP Class is specified, all " + "Transfer Syntaxes listed above except No Pixel Data " + "and No Pixel Data Delflate Transfer Syntax are " + "offered."); opts.addOption(OptionBuilder.create("cstore")); OptionBuilder.withArgName("dir"); OptionBuilder.hasArg(); OptionBuilder.withDescription("store received objects into files in specified directory <dir>." + " Do not store received objects by default."); opts.addOption(OptionBuilder.create("cstoredest")); opts.addOption("ivrle", false, "offer only Implicit VR Little Endian Transfer Syntax."); OptionBuilder.withArgName("maxops"); OptionBuilder.hasArg(); OptionBuilder.withDescription( "maximum number of outstanding C-MOVE-RQ " + "it may invoke asynchronously, 1 by default."); opts.addOption(OptionBuilder.create("async")); OptionBuilder.withArgName("maxops"); OptionBuilder.hasArg(); OptionBuilder.withDescription("maximum number of outstanding storage operations performed " + "asynchronously, unlimited by default."); opts.addOption(OptionBuilder.create("storeasync")); opts.addOption("noextneg", false, "disable extended negotiation."); opts.addOption("rel", false, "negotiate support of relational queries and retrieval."); opts.addOption("datetime", false, "negotiate support of combined date and time attribute range matching."); opts.addOption("fuzzy", false, "negotiate support of fuzzy semantic person name attribute matching."); opts.addOption("retall", false, "negotiate private FIND SOP Classes " + "to fetch all available attributes of matching entities."); opts.addOption("blocked", false, "negotiate private FIND SOP Classes " + "to return attributes of several matching entities per FIND " + "response."); opts.addOption("vmf", false, "negotiate private FIND SOP Classes to " + "return attributes of legacy CT/MR images of one series as " + "virtual multiframe object."); opts.addOption("pdv1", false, "send only one PDV in one P-Data-TF PDU, pack command and data " + "PDV in one P-DATA-TF PDU by default."); opts.addOption("tcpdelay", false, "set TCP_NODELAY socket option to false, true by default"); OptionBuilder.withArgName("ms"); OptionBuilder.hasArg(); OptionBuilder.withDescription("timeout in ms for TCP connect, no timeout by default"); opts.addOption(OptionBuilder.create("connectTO")); OptionBuilder.withArgName("ms"); OptionBuilder.hasArg(); OptionBuilder.withDescription("delay in ms for Socket close after sending A-ABORT, 50ms by default"); opts.addOption(OptionBuilder.create("soclosedelay")); OptionBuilder.withArgName("ms"); OptionBuilder.hasArg(); OptionBuilder.withDescription("period in ms to check for outstanding DIMSE-RSP, 10s by default"); opts.addOption(OptionBuilder.create("reaper")); OptionBuilder.withArgName("ms"); OptionBuilder.hasArg(); OptionBuilder.withDescription("timeout in ms for receiving C-FIND-RSP, 60s by default"); opts.addOption(OptionBuilder.create("cfindrspTO")); OptionBuilder.withArgName("ms"); OptionBuilder.hasArg(); OptionBuilder.withDescription("timeout in ms for receiving C-MOVE-RSP and C-GET RSP, 600s by default"); opts.addOption(OptionBuilder.create("cmoverspTO")); OptionBuilder.withArgName("ms"); OptionBuilder.hasArg(); OptionBuilder.withDescription("timeout in ms for receiving C-GET-RSP and C-MOVE RSP, 600s by default"); opts.addOption(OptionBuilder.create("cgetrspTO")); OptionBuilder.withArgName("ms"); OptionBuilder.hasArg(); OptionBuilder.withDescription("timeout in ms for receiving A-ASSOCIATE-AC, 5s by default"); opts.addOption(OptionBuilder.create("acceptTO")); OptionBuilder.withArgName("ms"); OptionBuilder.hasArg(); OptionBuilder.withDescription("timeout in ms for receiving A-RELEASE-RP, 5s by default"); opts.addOption(OptionBuilder.create("releaseTO")); OptionBuilder.withArgName("KB"); OptionBuilder.hasArg(); OptionBuilder.withDescription("maximal length in KB of received P-DATA-TF PDUs, 16KB by default"); opts.addOption(OptionBuilder.create("rcvpdulen")); OptionBuilder.withArgName("KB"); OptionBuilder.hasArg(); OptionBuilder.withDescription("maximal length in KB of sent P-DATA-TF PDUs, 16KB by default"); opts.addOption(OptionBuilder.create("sndpdulen")); OptionBuilder.withArgName("KB"); OptionBuilder.hasArg(); OptionBuilder.withDescription("set SO_RCVBUF socket option to specified value in KB"); opts.addOption(OptionBuilder.create("sorcvbuf")); OptionBuilder.withArgName("KB"); OptionBuilder.hasArg(); OptionBuilder.withDescription("set SO_SNDBUF socket option to specified value in KB"); opts.addOption(OptionBuilder.create("sosndbuf")); OptionBuilder.withArgName("KB"); OptionBuilder.hasArg(); OptionBuilder.withDescription("minimal buffer size to write received object to file, 1KB by default"); opts.addOption(OptionBuilder.create("filebuf")); OptionGroup qrlevel = new OptionGroup(); OptionBuilder.withDescription("perform patient level query, multiple " + "exclusive with -S and -I, perform study level query " + "by default."); OptionBuilder.withLongOpt("patient"); qrlevel.addOption(OptionBuilder.create("P")); OptionBuilder.withDescription("perform series level query, multiple " + "exclusive with -P and -I, perform study level query " + "by default."); OptionBuilder.withLongOpt("series"); qrlevel.addOption(OptionBuilder.create("S")); OptionBuilder.withDescription("perform instance level query, multiple " + "exclusive with -P and -S, perform study level query " + "by default."); OptionBuilder.withLongOpt("image"); qrlevel.addOption(OptionBuilder.create("I")); OptionBuilder.withArgName("cuid"); OptionBuilder.hasArgs(); OptionBuilder.withDescription("negotiate addition private C-FIND SOP " + "class with specified UID"); opts.addOption(OptionBuilder.create("cfind")); opts.addOptionGroup(qrlevel); OptionBuilder.withArgName("[seq/]attr=value"); OptionBuilder.hasArgs(); OptionBuilder.withValueSeparator('='); OptionBuilder.withDescription( "specify matching key. attr can be " + "specified by name or tag value (in hex), e.g. PatientName " + "or 00100010. Attributes in nested Datasets can " + "be specified by including the name/tag value of " + "the sequence attribute, e.g. 00400275/00400009 " + "for Scheduled Procedure Step ID in the Request " + "Attributes Sequence"); opts.addOption(OptionBuilder.create("q")); OptionBuilder.withArgName("attr"); OptionBuilder.hasArgs(); OptionBuilder.withDescription( "specify additional return key. attr can " + "be specified by name or tag value (in hex)."); opts.addOption(OptionBuilder.create("r")); opts.addOption("nodefret", false, "only inlcude return keys specified by -r into the request."); OptionBuilder.withArgName("num"); OptionBuilder.hasArg(); OptionBuilder.withDescription( "cancel query after receive of specified " + "number of responses, no cancel by default"); opts.addOption(OptionBuilder.create("C")); OptionBuilder.withArgName("aet"); OptionBuilder.hasArg(); OptionBuilder.withDescription("retrieve matching objects to specified " + "move destination."); opts.addOption(OptionBuilder.create("cmove")); opts.addOption("evalRetrieveAET", false, "Only Move studies not allready stored on destination AET"); opts.addOption("lowprior", false, "LOW priority of the C-FIND/C-MOVE operation, MEDIUM by default"); opts.addOption("highprior", false, "HIGH priority of the C-FIND/C-MOVE operation, MEDIUM by default"); OptionBuilder.withArgName("num"); OptionBuilder.hasArg(); OptionBuilder.withDescription("repeat query (and retrieve) several times"); opts.addOption(OptionBuilder.create("repeat")); OptionBuilder.withArgName("ms"); OptionBuilder.hasArg(); OptionBuilder.withDescription("delay in ms between repeated query (and retrieve), no delay by default"); opts.addOption(OptionBuilder.create("repeatdelay")); opts.addOption("reuseassoc", false, "Reuse association for repeated query (and retrieve)"); opts.addOption("closeassoc", false, "Close association between repeated query (and retrieve)"); opts.addOption("h", "help", false, "print this message"); opts.addOption("V", "version", false, "print the version information and exit"); CommandLine cl = null; try { cl = new GnuParser().parse(opts, args); } catch (ParseException e) { exit("dcmqr: " + e.getMessage()); throw new RuntimeException("unreachable"); } if (cl.hasOption('V')) { Package p = DcmQR.class.getPackage(); System.out.println("dcmqr v" + p.getImplementationVersion()); System.exit(0); } if (cl.hasOption('h') || cl.getArgList().size() != 1) { HelpFormatter formatter = new HelpFormatter(); formatter.printHelp(USAGE, DESCRIPTION, opts, EXAMPLE); System.exit(0); } return cl; } @SuppressWarnings("unchecked") public static void main(String[] args) { CommandLine cl = parse(args); DcmQR dcmqr = new DcmQR(cl.hasOption("device") ? cl.getOptionValue("device") : "DCMQR"); final List<String> argList = cl.getArgList(); String remoteAE = argList.get(0); String[] calledAETAddress = split(remoteAE, '@'); dcmqr.setCalledAET(calledAETAddress[0], cl.hasOption("reuseassoc")); if (calledAETAddress[1] == null) { dcmqr.setRemoteHost("127.0.0.1"); dcmqr.setRemotePort(104); } else { String[] hostPort = split(calledAETAddress[1], ':'); dcmqr.setRemoteHost(hostPort[0]); dcmqr.setRemotePort(toPort(hostPort[1])); } if (cl.hasOption("L")) { String localAE = cl.getOptionValue("L"); String[] localPort = split(localAE, ':'); if (localPort[1] != null) { dcmqr.setLocalPort(toPort(localPort[1])); } String[] callingAETHost = split(localPort[0], '@'); dcmqr.setCalling(callingAETHost[0]); if (callingAETHost[1] != null) { dcmqr.setLocalHost(callingAETHost[1]); } } if (cl.hasOption("username")) { String username = cl.getOptionValue("username"); UserIdentity userId; if (cl.hasOption("passcode")) { String passcode = cl.getOptionValue("passcode"); userId = new UserIdentity.UsernamePasscode(username, passcode.toCharArray()); } else { userId = new UserIdentity.Username(username); } userId.setPositiveResponseRequested(cl.hasOption("uidnegrsp")); dcmqr.setUserIdentity(userId); } if (cl.hasOption("connectTO")) dcmqr.setConnectTimeout(parseInt(cl.getOptionValue("connectTO"), "illegal argument of option -connectTO", 1, Integer.MAX_VALUE)); if (cl.hasOption("reaper")) dcmqr.setAssociationReaperPeriod(parseInt(cl.getOptionValue("reaper"), "illegal argument of option -reaper", 1, Integer.MAX_VALUE)); if (cl.hasOption("cfindrspTO")) dcmqr.setDimseRspTimeout(parseInt(cl.getOptionValue("cfindrspTO"), "illegal argument of option -cfindrspTO", 1, Integer.MAX_VALUE)); if (cl.hasOption("cmoverspTO")) dcmqr.setRetrieveRspTimeout(parseInt(cl.getOptionValue("cmoverspTO"), "illegal argument of option -cmoverspTO", 1, Integer.MAX_VALUE)); if (cl.hasOption("cgetrspTO")) dcmqr.setRetrieveRspTimeout(parseInt(cl.getOptionValue("cgetrspTO"), "illegal argument of option -cgetrspTO", 1, Integer.MAX_VALUE)); if (cl.hasOption("acceptTO")) dcmqr.setAcceptTimeout(parseInt(cl.getOptionValue("acceptTO"), "illegal argument of option -acceptTO", 1, Integer.MAX_VALUE)); if (cl.hasOption("releaseTO")) dcmqr.setReleaseTimeout(parseInt(cl.getOptionValue("releaseTO"), "illegal argument of option -releaseTO", 1, Integer.MAX_VALUE)); if (cl.hasOption("soclosedelay")) dcmqr.setSocketCloseDelay(parseInt(cl.getOptionValue("soclosedelay"), "illegal argument of option -soclosedelay", 1, 10000)); if (cl.hasOption("rcvpdulen")) dcmqr.setMaxPDULengthReceive( parseInt(cl.getOptionValue("rcvpdulen"), "illegal argument of option -rcvpdulen", 1, 10000) * KB); if (cl.hasOption("sndpdulen")) dcmqr.setMaxPDULengthSend( parseInt(cl.getOptionValue("sndpdulen"), "illegal argument of option -sndpdulen", 1, 10000) * KB); if (cl.hasOption("sosndbuf")) dcmqr.setSendBufferSize( parseInt(cl.getOptionValue("sosndbuf"), "illegal argument of option -sosndbuf", 1, 10000) * KB); if (cl.hasOption("sorcvbuf")) dcmqr.setReceiveBufferSize( parseInt(cl.getOptionValue("sorcvbuf"), "illegal argument of option -sorcvbuf", 1, 10000) * KB); if (cl.hasOption("filebuf")) dcmqr.setFileBufferSize( parseInt(cl.getOptionValue("filebuf"), "illegal argument of option -filebuf", 1, 10000) * KB); dcmqr.setPackPDV(!cl.hasOption("pdv1")); dcmqr.setTcpNoDelay(!cl.hasOption("tcpdelay")); dcmqr.setMaxOpsInvoked(cl.hasOption("async") ? parseInt(cl.getOptionValue("async"), "illegal argument of option -async", 0, 0xffff) : 1); dcmqr.setMaxOpsPerformed(cl.hasOption("cstoreasync") ? parseInt(cl.getOptionValue("cstoreasync"), "illegal argument of option -cstoreasync", 0, 0xffff) : 0); if (cl.hasOption("C")) dcmqr.setCancelAfter( parseInt(cl.getOptionValue("C"), "illegal argument of option -C", 1, Integer.MAX_VALUE)); if (cl.hasOption("lowprior")) dcmqr.setPriority(CommandUtils.LOW); if (cl.hasOption("highprior")) dcmqr.setPriority(CommandUtils.HIGH); if (cl.hasOption("cstore")) { String[] storeTCs = cl.getOptionValues("cstore"); for (String storeTC : storeTCs) { String cuid; String[] tsuids; int colon = storeTC.indexOf(':'); if (colon == -1) { cuid = storeTC; tsuids = DEF_TS; } else { cuid = storeTC.substring(0, colon); String ts = storeTC.substring(colon + 1); try { tsuids = TS.valueOf(ts).uids; } catch (IllegalArgumentException e) { tsuids = ts.split(","); } } try { cuid = CUID.valueOf(cuid).uid; } catch (IllegalArgumentException e) { // assume cuid already contains UID } dcmqr.addStoreTransferCapability(cuid, tsuids); } if (cl.hasOption("cstoredest")) dcmqr.setStoreDestination(cl.getOptionValue("cstoredest")); } dcmqr.setCFind(!cl.hasOption("nocfind")); dcmqr.setCGet(cl.hasOption("cget")); if (cl.hasOption("cmove")) dcmqr.setMoveDest(cl.getOptionValue("cmove")); if (cl.hasOption("evalRetrieveAET")) dcmqr.setEvalRetrieveAET(true); dcmqr.setQueryLevel(cl.hasOption("P") ? QueryRetrieveLevel.PATIENT : cl.hasOption("S") ? QueryRetrieveLevel.SERIES : cl.hasOption("I") ? QueryRetrieveLevel.IMAGE : QueryRetrieveLevel.STUDY); if (cl.hasOption("noextneg")) dcmqr.setNoExtNegotiation(true); if (cl.hasOption("rel")) dcmqr.setRelationQR(true); if (cl.hasOption("datetime")) dcmqr.setDateTimeMatching(true); if (cl.hasOption("fuzzy")) dcmqr.setFuzzySemanticPersonNameMatching(true); if (!cl.hasOption("P")) { if (cl.hasOption("retall")) dcmqr.addPrivate(UID.PrivateStudyRootQueryRetrieveInformationModelFIND); if (cl.hasOption("blocked")) dcmqr.addPrivate(UID.PrivateBlockedStudyRootQueryRetrieveInformationModelFIND); if (cl.hasOption("vmf")) dcmqr.addPrivate(UID.PrivateVirtualMultiframeStudyRootQueryRetrieveInformationModelFIND); } if (cl.hasOption("cfind")) { String[] cuids = cl.getOptionValues("cfind"); for (int i = 0; i < cuids.length; i++) dcmqr.addPrivate(cuids[i]); } if (!cl.hasOption("nodefret")) dcmqr.addDefReturnKeys(); if (cl.hasOption("r")) { String[] returnKeys = cl.getOptionValues("r"); for (int i = 0; i < returnKeys.length; i++) dcmqr.addReturnKey(Tag.toTagPath(returnKeys[i])); } if (cl.hasOption("q")) { String[] matchingKeys = cl.getOptionValues("q"); for (int i = 1; i < matchingKeys.length; i++, i++) dcmqr.addMatchingKey(Tag.toTagPath(matchingKeys[i - 1]), matchingKeys[i]); } dcmqr.configureTransferCapability(cl.hasOption("ivrle")); int repeat = cl.hasOption("repeat") ? parseInt(cl.getOptionValue("repeat"), "illegal argument of option -repeat", 1, Integer.MAX_VALUE) : 0; int interval = cl.hasOption("repeatdelay") ? parseInt(cl.getOptionValue("repeatdelay"), "illegal argument of option -repeatdelay", 1, Integer.MAX_VALUE) : 0; boolean closeAssoc = cl.hasOption("closeassoc"); if (cl.hasOption("tls")) { String cipher = cl.getOptionValue("tls"); if ("NULL".equalsIgnoreCase(cipher)) { dcmqr.setTlsWithoutEncyrption(); } else if ("3DES".equalsIgnoreCase(cipher)) { dcmqr.setTls3DES_EDE_CBC(); } else if ("AES".equalsIgnoreCase(cipher)) { dcmqr.setTlsAES_128_CBC(); } else { exit("Invalid parameter for option -tls: " + cipher); } if (cl.hasOption("tls1")) { dcmqr.setTlsProtocol(TLS1); } else if (cl.hasOption("ssl3")) { dcmqr.setTlsProtocol(SSL3); } else if (cl.hasOption("no_tls1")) { dcmqr.setTlsProtocol(NO_TLS1); } else if (cl.hasOption("no_ssl3")) { dcmqr.setTlsProtocol(NO_SSL3); } else if (cl.hasOption("no_ssl2")) { dcmqr.setTlsProtocol(NO_SSL2); } dcmqr.setTlsNeedClientAuth(!cl.hasOption("noclientauth")); if (cl.hasOption("keystore")) { dcmqr.setKeyStoreURL(cl.getOptionValue("keystore")); } if (cl.hasOption("keystorepw")) { dcmqr.setKeyStorePassword(cl.getOptionValue("keystorepw")); } if (cl.hasOption("keypw")) { dcmqr.setKeyPassword(cl.getOptionValue("keypw")); } if (cl.hasOption("truststore")) { dcmqr.setTrustStoreURL(cl.getOptionValue("truststore")); } if (cl.hasOption("truststorepw")) { dcmqr.setTrustStorePassword(cl.getOptionValue("truststorepw")); } long t1 = System.currentTimeMillis(); try { dcmqr.initTLS(); } catch (Exception e) { System.err.println("ERROR: Failed to initialize TLS context:" + e.getMessage()); System.exit(2); } long t2 = System.currentTimeMillis(); LOG.info("Initialize TLS context in {} s", Float.valueOf((t2 - t1) / 1000f)); } try { dcmqr.start(); } catch (Exception e) { System.err.println( "ERROR: Failed to start server for receiving " + "requested objects:" + e.getMessage()); System.exit(2); } try { long t1 = System.currentTimeMillis(); try { dcmqr.open(); } catch (Exception e) { LOG.error("Failed to establish association:", e); System.exit(2); } long t2 = System.currentTimeMillis(); LOG.info("Connected to {} in {} s", remoteAE, Float.valueOf((t2 - t1) / 1000f)); for (;;) { List<DicomObject> result; if (dcmqr.isCFind()) { result = dcmqr.query(); long t3 = System.currentTimeMillis(); LOG.info("Received {} matching entries in {} s", Integer.valueOf(result.size()), Float.valueOf((t3 - t2) / 1000f)); t2 = t3; } else { result = Collections.singletonList(dcmqr.getKeys()); } if (dcmqr.isCMove() || dcmqr.isCGet()) { if (dcmqr.isCMove()) dcmqr.move(result); else dcmqr.get(result); long t4 = System.currentTimeMillis(); LOG.info("Retrieved {} objects (warning: {}, failed: {}) in {}s", new Object[] { Integer.valueOf(dcmqr.getTotalRetrieved()), Integer.valueOf(dcmqr.getWarning()), Integer.valueOf(dcmqr.getFailed()), Float.valueOf((t4 - t2) / 1000f) }); } if (repeat == 0 || closeAssoc) { try { dcmqr.close(); } catch (InterruptedException e) { LOG.error(e.getMessage(), e); } LOG.info("Released connection to {}", remoteAE); } if (repeat-- == 0) break; Thread.sleep(interval); long t4 = System.currentTimeMillis(); dcmqr.open(); t2 = System.currentTimeMillis(); LOG.info("Reconnect or reuse connection to {} in {} s", remoteAE, Float.valueOf((t2 - t4) / 1000f)); } } catch (IOException e) { LOG.error(e.getMessage(), e); } catch (InterruptedException e) { LOG.error(e.getMessage(), e); } catch (ConfigurationException e) { LOG.error(e.getMessage(), e); } finally { dcmqr.stop(); } } public void addStoreTransferCapability(String cuid, String[] tsuids) { this.storeTransferCapability.add(new TransferCapability(cuid, tsuids, TransferCapability.SCP)); } public void setEvalRetrieveAET(boolean evalRetrieveAET) { this.evalRetrieveAET = evalRetrieveAET; } public boolean isEvalRetrieveAET() { return this.evalRetrieveAET; } public void setNoExtNegotiation(boolean b) { this.noExtNegotiation = b; } public void setFuzzySemanticPersonNameMatching(boolean b) { this.fuzzySemanticPersonNameMatching = b; } public void setDateTimeMatching(boolean b) { this.dateTimeMatching = b; } public void setRelationQR(boolean b) { this.relationQR = b; } public final int getFailed() { return this.failed; } public final int getWarning() { return this.warning; } public final int getTotalRetrieved() { return this.completed + this.warning; } public void setCancelAfter(int limit) { this.cancelAfter = limit; } public void addMatchingKey(int[] tagPath, String value) { this.keys.putString(tagPath, null, value); } public void addReturnKey(int[] tagPath) { this.keys.putNull(tagPath, null); } public void addDefReturnKeys() { for (int tag : this.qrlevel.getReturnKeys()) this.keys.putNull(tag, null); } public void configureTransferCapability(boolean ivrle) { String[] findcuids = this.qrlevel.getFindClassUids(); String[] movecuids = this.moveDest != null ? this.qrlevel.getMoveClassUids() : EMPTY_STRING; String[] getcuids = this.cget ? this.qrlevel.getGetClassUids() : EMPTY_STRING; TransferCapability[] tcs = new TransferCapability[findcuids.length + this.privateFind.size() + movecuids.length + getcuids.length + this.storeTransferCapability.size()]; int i = 0; for (String cuid : findcuids) tcs[i++] = mkFindTC(cuid, ivrle ? IVRLE_TS : NATIVE_LE_TS); for (String cuid : this.privateFind) tcs[i++] = mkFindTC(cuid, ivrle ? IVRLE_TS : DEFLATED_TS); for (String cuid : movecuids) tcs[i++] = mkRetrieveTC(cuid, ivrle ? IVRLE_TS : NATIVE_LE_TS); for (String cuid : getcuids) tcs[i++] = mkRetrieveTC(cuid, ivrle ? IVRLE_TS : NATIVE_LE_TS); for (TransferCapability tc : this.storeTransferCapability) { tcs[i++] = tc; } this.ae.setTransferCapability(tcs); if (!this.storeTransferCapability.isEmpty()) { this.ae.register(createStorageService()); } } private DicomService createStorageService() { String[] cuids = new String[this.storeTransferCapability.size()]; int i = 0; for (TransferCapability tc : this.storeTransferCapability) { cuids[i++] = tc.getSopClass(); } return new StorageService(cuids) { @Override protected void onCStoreRQ(Association as, int pcid, DicomObject rq, PDVInputStream dataStream, String tsuid, DicomObject rsp) throws IOException, DicomServiceException { if (DcmQR.this.storeDest == null) { super.onCStoreRQ(as, pcid, rq, dataStream, tsuid, rsp); } else { try { String cuid = rq.getString(Tag.AffectedSOPClassUID); String iuid = rq.getString(Tag.AffectedSOPInstanceUID); BasicDicomObject fmi = new BasicDicomObject(); fmi.initFileMetaInformation(cuid, iuid, tsuid); File file = DcmQR.this.devnull ? DcmQR.this.storeDest : new File(DcmQR.this.storeDest, iuid); FileOutputStream fos = new FileOutputStream(file); BufferedOutputStream bos = new BufferedOutputStream(fos, DcmQR.this.fileBufferSize); DicomOutputStream dos = new DicomOutputStream(bos); dos.writeFileMetaInformation(fmi); dataStream.copyTo(dos); dos.close(); } catch (IOException e) { throw new DicomServiceException(rq, Status.ProcessingFailure, e.getMessage()); } } } }; } private TransferCapability mkRetrieveTC(String cuid, String[] ts) { ExtRetrieveTransferCapability tc = new ExtRetrieveTransferCapability(cuid, ts, TransferCapability.SCU); tc.setExtInfoBoolean(ExtRetrieveTransferCapability.RELATIONAL_RETRIEVAL, this.relationQR); if (this.noExtNegotiation) tc.setExtInfo(null); return tc; } private TransferCapability mkFindTC(String cuid, String[] ts) { ExtQueryTransferCapability tc = new ExtQueryTransferCapability(cuid, ts, TransferCapability.SCU); tc.setExtInfoBoolean(ExtQueryTransferCapability.RELATIONAL_QUERIES, this.relationQR); tc.setExtInfoBoolean(ExtQueryTransferCapability.DATE_TIME_MATCHING, this.dateTimeMatching); tc.setExtInfoBoolean(ExtQueryTransferCapability.FUZZY_SEMANTIC_PN_MATCHING, this.fuzzySemanticPersonNameMatching); if (this.noExtNegotiation) tc.setExtInfo(null); return tc; } public void setQueryLevel(QueryRetrieveLevel qrlevel) { this.qrlevel = qrlevel; this.keys.putString(Tag.QueryRetrieveLevel, VR.CS, qrlevel.getCode()); } public final void addPrivate(String cuid) { this.privateFind.add(cuid); } public void setCFind(boolean cfind) { this.cfind = cfind; } public boolean isCFind() { return this.cfind; } public void setCGet(boolean cget) { this.cget = cget; } public boolean isCGet() { return this.cget; } public void setMoveDest(String aet) { this.moveDest = aet; } public boolean isCMove() { return this.moveDest != null; } private static int toPort(String port) { return port != null ? parseInt(port, "illegal port number", 1, 0xffff) : 104; } private static int parseInt(String s, String errPrompt, int min, int max) { try { int i = Integer.parseInt(s); if (i >= min && i <= max) return i; } catch (NumberFormatException e) { // parameter is not a valid integer; fall through to exit } exit(errPrompt); throw new RuntimeException(); } private static String[] split(String s, char delim) { String[] s2 = { s, null }; int pos = s.indexOf(delim); if (pos != -1) { s2[0] = s.substring(0, pos); s2[1] = s.substring(pos + 1); } return s2; } private static void exit(String msg) { System.err.println(msg); System.err.println("Try 'dcmqr -h' for more information."); System.exit(1); } public void start() throws IOException { if (this.conn.isListening()) { this.conn.bind(this.executor); System.out.println("Start Server listening on port " + this.conn.getPort()); } } public void stop() { if (this.conn.isListening()) { this.conn.unbind(); } } public void open() throws IOException, ConfigurationException, InterruptedException { this.assoc = this.ae.connect(this.remoteAE, this.executor); } public DicomObject getKeys() { return this.keys; } public List<DicomObject> query() throws IOException, InterruptedException { List<DicomObject> result = new ArrayList<>(); TransferCapability tc = selectFindTransferCapability(); String cuid = tc.getSopClass(); String tsuid = selectTransferSyntax(tc); if (tc.getExtInfoBoolean(ExtQueryTransferCapability.RELATIONAL_QUERIES) || containsUpperLevelUIDs(cuid)) { LOG.info("Send Query Request using {}:\n{}", UIDDictionary.getDictionary().prompt(cuid), this.keys); DimseRSP rsp = this.assoc.cfind(cuid, this.priority, this.keys, tsuid, this.cancelAfter); while (rsp.next()) { DicomObject cmd = rsp.getCommand(); if (CommandUtils.isPending(cmd)) { DicomObject data = rsp.getDataset(); result.add(data); LOG.info("Query Response #{}:\n{}", Integer.valueOf(result.size()), data); } } } else { List<DicomObject> upperLevelUIDs = queryUpperLevelUIDs(cuid, tsuid); List<DimseRSP> rspList = new ArrayList<>(upperLevelUIDs.size()); for (int i = 0, n = upperLevelUIDs.size(); i < n; i++) { upperLevelUIDs.get(i).copyTo(this.keys); LOG.info("Send Query Request #{}/{} using {}:\n{}", new Object[] { Integer.valueOf(i + 1), Integer.valueOf(n), UIDDictionary.getDictionary().prompt(cuid), this.keys }); rspList.add(this.assoc.cfind(cuid, this.priority, this.keys, tsuid, this.cancelAfter)); } for (int i = 0, n = rspList.size(); i < n; i++) { DimseRSP rsp = rspList.get(i); for (int j = 0; rsp.next(); ++j) { DicomObject cmd = rsp.getCommand(); if (CommandUtils.isPending(cmd)) { DicomObject data = rsp.getDataset(); result.add(data); LOG.info("Query Response #{} for Query Request #{}/{}:\n{}", new Object[] { Integer.valueOf(j + 1), Integer.valueOf(i + 1), Integer.valueOf(n), data }); } } } } return result; } @SuppressWarnings("fallthrough") private boolean containsUpperLevelUIDs(String cuid) { switch (this.qrlevel) { case IMAGE: if (!this.keys.containsValue(Tag.SeriesInstanceUID)) { return false; } // fall through case SERIES: if (!this.keys.containsValue(Tag.StudyInstanceUID)) { return false; } // fall through case STUDY: if (Arrays.asList(PATIENT_LEVEL_FIND_CUID).contains(cuid) && !this.keys.containsValue(Tag.PatientID)) { return false; } // fall through case PATIENT: // fall through default: break; } return true; } private List<DicomObject> queryUpperLevelUIDs(String cuid, String tsuid) throws IOException, InterruptedException { List<DicomObject> keylist = new ArrayList<>(); if (Arrays.asList(PATIENT_LEVEL_FIND_CUID).contains(cuid)) { queryPatientIDs(cuid, tsuid, keylist); if (this.qrlevel == QueryRetrieveLevel.STUDY) { return keylist; } keylist = queryStudyOrSeriesIUIDs(cuid, tsuid, keylist, Tag.StudyInstanceUID, STUDY_MATCHING_KEYS, QueryRetrieveLevel.STUDY); } else { keylist.add(new BasicDicomObject()); keylist = queryStudyOrSeriesIUIDs(cuid, tsuid, keylist, Tag.StudyInstanceUID, PATIENT_STUDY_MATCHING_KEYS, QueryRetrieveLevel.STUDY); } if (this.qrlevel == QueryRetrieveLevel.IMAGE) { keylist = queryStudyOrSeriesIUIDs(cuid, tsuid, keylist, Tag.SeriesInstanceUID, SERIES_MATCHING_KEYS, QueryRetrieveLevel.SERIES); } return keylist; } private void queryPatientIDs(String cuid, String tsuid, List<DicomObject> keylist) throws IOException, InterruptedException { String patID = this.keys.getString(Tag.PatientID); String issuer = this.keys.getString(Tag.IssuerOfPatientID); if (patID != null) { DicomObject patIdKeys = new BasicDicomObject(); patIdKeys.putString(Tag.PatientID, VR.LO, patID); if (issuer != null) { patIdKeys.putString(Tag.IssuerOfPatientID, VR.LO, issuer); } keylist.add(patIdKeys); } else { DicomObject patLevelQuery = new BasicDicomObject(); this.keys.subSet(PATIENT_MATCHING_KEYS).copyTo(patLevelQuery); patLevelQuery.putNull(Tag.PatientID, VR.LO); patLevelQuery.putNull(Tag.IssuerOfPatientID, VR.LO); patLevelQuery.putString(Tag.QueryRetrieveLevel, VR.CS, "PATIENT"); LOG.info("Send Query Request using {}:\n{}", UIDDictionary.getDictionary().prompt(cuid), patLevelQuery); DimseRSP rsp = this.assoc.cfind(cuid, this.priority, patLevelQuery, tsuid, Integer.MAX_VALUE); for (int i = 0; rsp.next(); ++i) { DicomObject cmd = rsp.getCommand(); if (CommandUtils.isPending(cmd)) { DicomObject data = rsp.getDataset(); LOG.info("Query Response #{}:\n{}", Integer.valueOf(i + 1), data); DicomObject patIdKeys = new BasicDicomObject(); patIdKeys.putString(Tag.PatientID, VR.LO, data.getString(Tag.PatientID)); issuer = this.keys.getString(Tag.IssuerOfPatientID); if (issuer != null) { patIdKeys.putString(Tag.IssuerOfPatientID, VR.LO, issuer); } keylist.add(patIdKeys); } } } } private List<DicomObject> queryStudyOrSeriesIUIDs(String cuid, String tsuid, List<DicomObject> upperLevelIDs, int uidTag, int[] matchingKeys, QueryRetrieveLevel qrLevel) throws IOException, InterruptedException { List<DicomObject> keylist = new ArrayList<>(); String uid = this.keys.getString(uidTag); for (DicomObject upperLevelID : upperLevelIDs) { if (uid != null) { DicomObject suidKey = new BasicDicomObject(); upperLevelID.copyTo(suidKey); suidKey.putString(uidTag, VR.UI, uid); keylist.add(suidKey); } else { DicomObject keys2 = new BasicDicomObject(); this.keys.subSet(matchingKeys).copyTo(keys2); upperLevelID.copyTo(keys2); keys2.putNull(uidTag, VR.UI); keys2.putString(Tag.QueryRetrieveLevel, VR.CS, qrLevel.getCode()); LOG.info("Send Query Request using {}:\n{}", UIDDictionary.getDictionary().prompt(cuid), keys2); DimseRSP rsp = this.assoc.cfind(cuid, this.priority, keys2, tsuid, Integer.MAX_VALUE); for (int i = 0; rsp.next(); ++i) { DicomObject cmd = rsp.getCommand(); if (CommandUtils.isPending(cmd)) { DicomObject data = rsp.getDataset(); LOG.info("Query Response #{}:\n{}", Integer.valueOf(i + 1), data); DicomObject suidKey = new BasicDicomObject(); upperLevelID.copyTo(suidKey); suidKey.putString(uidTag, VR.UI, data.getString(uidTag)); keylist.add(suidKey); } } } } return keylist; } public TransferCapability selectFindTransferCapability() throws NoPresentationContextException { TransferCapability tc; if ((tc = selectTransferCapability(this.privateFind)) != null) return tc; if ((tc = selectTransferCapability(this.qrlevel.getFindClassUids())) != null) return tc; throw new NoPresentationContextException( UIDDictionary.getDictionary().prompt(this.qrlevel.getFindClassUids()[0]) + " not supported by " + this.remoteAE.getAETitle()); } public static String selectTransferSyntax(TransferCapability tc) { String[] tcuids = tc.getTransferSyntax(); if (Arrays.asList(tcuids).indexOf(UID.DeflatedExplicitVRLittleEndian) != -1) return UID.DeflatedExplicitVRLittleEndian; return tcuids[0]; } public void move(List<DicomObject> findResults) throws IOException, InterruptedException { if (this.moveDest == null) throw new IllegalStateException("moveDest == null"); TransferCapability tc = selectTransferCapability(this.qrlevel.getMoveClassUids()); if (tc == null) throw new NoPresentationContextException( UIDDictionary.getDictionary().prompt(this.qrlevel.getMoveClassUids()[0]) + " not supported by " + this.remoteAE.getAETitle()); String cuid = tc.getSopClass(); String tsuid = selectTransferSyntax(tc); for (int i = 0, n = Math.min(findResults.size(), this.cancelAfter); i < n; ++i) { DicomObject keys = findResults.get(i).subSet(MOVE_KEYS); if (isEvalRetrieveAET() && containsMoveDest(findResults.get(i).getStrings(Tag.RetrieveAETitle))) { LOG.info("Skipping {}:\n{}", UIDDictionary.getDictionary().prompt(cuid), keys); } else { LOG.info("Send Retrieve Request using {}:\n{}", UIDDictionary.getDictionary().prompt(cuid), keys); this.assoc.cmove(cuid, this.priority, keys, tsuid, this.moveDest, this.rspHandler); } } this.assoc.waitForDimseRSP(); } private boolean containsMoveDest(String[] retrieveAETs) { if (retrieveAETs != null) { for (String aet : retrieveAETs) { if (this.moveDest.equals(aet)) { return true; } } } return false; } public void get(List<DicomObject> findResults) throws IOException, InterruptedException { TransferCapability tc = selectTransferCapability(this.qrlevel.getGetClassUids()); if (tc == null) throw new NoPresentationContextException( UIDDictionary.getDictionary().prompt(this.qrlevel.getGetClassUids()[0]) + " not supported by " + this.remoteAE.getAETitle()); String cuid = tc.getSopClass(); String tsuid = selectTransferSyntax(tc); for (int i = 0, n = Math.min(findResults.size(), this.cancelAfter); i < n; ++i) { DicomObject keys = findResults.get(i).subSet(MOVE_KEYS); LOG.info("Send Retrieve Request using {}:\n{}", UIDDictionary.getDictionary().prompt(cuid), keys); this.assoc.cget(cuid, this.priority, keys, tsuid, this.rspHandler); } this.assoc.waitForDimseRSP(); } private final DimseRSPHandler rspHandler = new DimseRSPHandler() { @Override public void onDimseRSP(Association as, DicomObject cmd, DicomObject data) { DcmQR.this.onMoveRSP(as, cmd, data); } }; protected void onMoveRSP(Association as, DicomObject cmd, DicomObject data) { if (!CommandUtils.isPending(cmd)) { this.completed += cmd.getInt(Tag.NumberOfCompletedSuboperations); this.warning += cmd.getInt(Tag.NumberOfWarningSuboperations); this.failed += cmd.getInt(Tag.NumberOfFailedSuboperations); } } public TransferCapability selectTransferCapability(String[] cuid) { TransferCapability tc; for (int i = 0; i < cuid.length; i++) { tc = this.assoc.getTransferCapabilityAsSCU(cuid[i]); if (tc != null) return tc; } return null; } public TransferCapability selectTransferCapability(List<String> cuid) { TransferCapability tc; for (int i = 0, n = cuid.size(); i < n; i++) { tc = this.assoc.getTransferCapabilityAsSCU(cuid.get(i)); if (tc != null) return tc; } return null; } public void close() throws InterruptedException { this.assoc.release(true); } public void setStoreDestination(String filePath) { this.storeDest = new File(filePath); this.devnull = "/dev/null".equals(filePath); if (!this.devnull) this.storeDest.mkdir(); } public void initTLS() throws GeneralSecurityException, IOException { KeyStore keyStore = loadKeyStore(this.keyStoreURL, this.keyStorePassword); KeyStore trustStore = loadKeyStore(this.trustStoreURL, this.trustStorePassword); this.device.initTLS(keyStore, this.keyPassword != null ? this.keyPassword : this.keyStorePassword, trustStore); } private static KeyStore loadKeyStore(String url, char[] password) throws GeneralSecurityException, IOException { KeyStore key = KeyStore.getInstance(toKeyStoreType(url)); InputStream in = openFileOrURL(url); try { key.load(in, password); } finally { in.close(); } return key; } private static InputStream openFileOrURL(String url) throws IOException { if (url.startsWith("resource:")) { return DcmQR.class.getClassLoader().getResourceAsStream(url.substring(9)); } try { return new URL(url).openStream(); } catch (MalformedURLException e) { return new FileInputStream(url); } } private static String toKeyStoreType(String fname) { return fname.endsWith(".p12") || fname.endsWith(".P12") ? "PKCS12" : "JKS"; } }