180 likes | 305 Views
Building an Adapter. Session Agenda. Review of CONNECT components Project/source layout Customization of adapter components. Assumptions/Expectations. Familiarity with… Java Service Oriented Architecture (SOA) NetBeans GlassFishESB. Review of CONNECT Components.
E N D
Session Agenda Review of CONNECT components Project/source layout Customization of adapter components
Assumptions/Expectations Familiarity with… Java Service Oriented Architecture (SOA) NetBeans GlassFishESB
Project Creation Guidelines • WIKI page describes the projects • http://developer.connectopensource.org/display/CONNECTWIKI/Project+Creation+Guidelines
Web Service WSDL File Naming Conventions • First part identifies the type of service • Adapter: Services on the adapter • Entity: Services on the gateway which are called by the adapter • Nhinc: Services on the gateway that are internal to the gateway • Nhin: NHIN services hosted or called by the CONNECT gateway • If “component” identified in second part… • NhincComponent: Identifies internal components to the gateway • AdapterComponent: Identifies services on the Adapter Service Bus • Used to customize an adapter service • EntityComponent: Identifies gateway internal services which orchestrate a message • Adapter/Entity interfaces may contain word Secured/Unsecured • Identifies whether the interface represents the secured or unsecured interface • Rest of the name identifies the service • Example • AdapterComponentSecuredMPI.wsdl
XML Schema Layout and Naming Conventions • Directory: Interfaces\src\schemas • First level of hierarchy: identifies organization or type of schemas • schemas\nhinc: CONNECT schemas • schemas\nhinc\common: used in gateway and adapter • schemas\nhinc\gateway: used in gateway • schemas\nhinc\hl7: schemas to combine HL7 messages
Connection Manager • Manages endpoint URLs • NHIN services • Replaceable services • Two points of configuration • UDDI • UDDI Update Manager service • uddiConnectionInfo.xml: CONNECT service information cache • Do not modify this file by hand • Internal • Used to override UDDI settings – settings here take precedence over UDDI • Used for non UDDI supported services • internalConnectionInfo.xml
Example internalConnectionInfo.xml <?xml version="1.0" encoding="UTF-8"?> <InternalConnectionInfos> <internalConnectionInfo> <homeCommunityId>1.1</homeCommunityId> <name>DoD</name> <description>DoD Description</description> <services> <service> <name>subjectdiscovery</name> <description>subjectdiscovery</description> <endpointURL> https://localhost:8181/PIXConsumer_Service/SubjectDiscovery </endpointURL> </service> <service> <name>nhincsubjectdiscovery</name> <description>NHIN-CONNECT Internal Subject Discovery</description> <endpointURL> http://localhost:9080/NhinConnect/NhincSubjectDiscovery </endpointURL> </service> </services> </internalConnectionInfo> </InternalConnectioninfos>
Steps for Customizing an Adapter Component Create a Web Service that implements the correct WSDL Deploy the web service Update internalConnectionInfo.xml with the URL for the customized WSDL