All Downloads are FREE. Search and download functionalities are using the official Maven repository.

ca.uhn.hl7v2.hoh.llp.Hl7OverHttpLowerLayerProtocol Maven / Gradle / Ivy

package ca.uhn.hl7v2.hoh.llp;

import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.nio.charset.Charset;

import ca.uhn.hl7v2.app.TwoPortService;
import ca.uhn.hl7v2.hoh.api.IAuthorizationClientCallback;
import ca.uhn.hl7v2.hoh.api.IAuthorizationServerCallback;
import ca.uhn.hl7v2.hoh.sign.ISigner;
import ca.uhn.hl7v2.hoh.util.ServerRoleEnum;
import ca.uhn.hl7v2.llp.HL7Reader;
import ca.uhn.hl7v2.llp.HL7Writer;
import ca.uhn.hl7v2.llp.LLPException;
import ca.uhn.hl7v2.llp.LowerLayerProtocol;

/**
 * 

* LowerLayerProtocol implementation which use the HL7 over HTTP specification * as a transport layer. *

* *

* Note that this implementation has limitations: *

    *
  • It will not work on a duel socket server such as {@link TwoPortService} *
*

*/ public class Hl7OverHttpLowerLayerProtocol extends LowerLayerProtocol { private IAuthorizationClientCallback myAuthorizationClientCallback; private IAuthorizationServerCallback myAuthorizationServerCallback; private HohLlpReader myNextReader; private HohLlpWriter myNextWriter; private ServerRoleEnum myRole; private ISigner mySigner; private String myUriPath = "/"; private Charset myPreferredCharset; public Hl7OverHttpLowerLayerProtocol(ServerRoleEnum theRole) { myRole = theRole; if (myRole == null) { throw new NullPointerException("Role can not be null"); } } /** * @return the authorizationClientCallback */ IAuthorizationClientCallback getAuthorizationClientCallback() { return myAuthorizationClientCallback; } /** * Provide the authorization callback, if any */ IAuthorizationServerCallback getAuthorizationServerCallback() { return myAuthorizationServerCallback; } /** * {@inheritDoc} */ @Override public HL7Reader getReader(InputStream theArg0) throws LLPException { if (myNextReader == null && myNextWriter != null) { myNextWriter = null; throw new LLPException("Hl7OverHttpLowerLayerProtocol can not be used with a multi socket implementation"); } prepareReadersIfNeeded(); HohLlpReader retVal = myNextReader; try { retVal.setInputStream(theArg0); } catch (IOException e) { throw new LLPException("Failed to set stream: " + e.getMessage(), e); } myNextReader = null; return retVal; } /** * Returns the server role this protocol implementation is being used for */ public ServerRoleEnum getRole() { return myRole; } /** * @return The signature profile signer * @see #setSigner(ISigner) */ ISigner getSigner() { return mySigner; } /** * @return The URI to use for this LLP implementation * @see #setUriPath(String) */ public String getUriPath() { return myUriPath; } /** * {@inheritDoc} */ @Override public HL7Writer getWriter(OutputStream theArg0) throws LLPException { if (myNextReader != null && myNextWriter == null) { myNextReader = null; throw new LLPException("Hl7OverHttpLowerLayerProtocol can not be used with a multi socket implementation"); } prepareReadersIfNeeded(); HohLlpWriter retVal = myNextWriter; retVal.setPreferredCharset(myPreferredCharset); try { retVal.setOutputStream(theArg0); } catch (IOException e) { throw new LLPException("Failed to set stream: " + e.getMessage(), e); } myNextWriter = null; return retVal; } private void prepareReadersIfNeeded() { if (myNextReader == null && myNextWriter == null) { myNextReader = new HohLlpReader(this); myNextWriter = new HohLlpWriter(this); myNextReader.setWriter(myNextWriter); } } /** * Provides an authorization callback for authorizing incoming requests. This method * must only be called of this LLP instance is in {@link ServerRoleEnum#SERVER SERVER} mode. */ public void setAuthorizationCallback(IAuthorizationClientCallback theAuthorizationClientCallback) { if (myRole == ServerRoleEnum.SERVER) { throw new IllegalStateException("This LLP implementation is in CLIENT mode, so it can not use an authorization callback"); } myAuthorizationClientCallback = theAuthorizationClientCallback; } /** * Provides an authorization callback for authorizing incoming requests. This method * must only be called of this LLP instance is in {@link ServerRoleEnum#SERVER SERVER} mode. */ public void setAuthorizationCallback(IAuthorizationServerCallback theAuthorizationCallback) { if (myRole == ServerRoleEnum.CLIENT) { throw new IllegalStateException("This LLP implementation is in CLIENT mode, so it can not use an authorization callback"); } myAuthorizationServerCallback = theAuthorizationCallback; } /** * @param theSigner The signature profile signer */ public void setSigner(ISigner theSigner) { mySigner = theSigner; } /** * The URI path to use for this protocol. The URI path is the portion of the address (URL) which * is being accessed which designates the location on the host (i.e. the "path"). By * default this is set to "/" * * @param theUriPath the uri to set */ public void setUriPath(String theUriPath) { myUriPath = theUriPath; } /** * Sets the charset which will be used for any initiated outgoing messages. What this * means is that if a message is sent as a response (e.g. an ACK) using this LLP, * the LLP will ignore the charset provided by this method and will attempt to use * the charset used in the original incoming message. On the other hand, if a new * outgoing message is transmitted using this LLP (i.e. not an ACK), the charset * specified here will be used. */ public void setPreferredCharset(Charset thePreferredCharset) { myPreferredCharset = thePreferredCharset; } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy