Using The Http Binding Component In Web Services

Transcript

  UsingtheHTTPBindingComponent SunMicrosystems,Inc.4150NetworkCircleSantaClara,CA95054U.S.A. PartNo:820–0595December2008  Copyright2008SunMicrosystems,Inc. 4150NetworkCircle,SantaClara,CA95054U.S.A. Allrightsreserved.SunMicrosystems,Inc.hasintellectualpropertyrightsrelatingtotechnologyembodiedintheproductthatisdescribedinthisdocument.Inparticular,andwithoutlimitation,theseintellectualpropertyrightsmayincludeoneormoreU.S.patentsorpendingpatentapplicationsintheU.S.andinothercountries.U.S.GovernmentRights–Commercialsotware.GovernmentusersaresubjecttotheSunMicrosystems,Inc.standardlicenseagreementandapplicableprovisionsotheFARanditssupplements.Thisdistributionmayincludematerialsdevelopedbythirdparties.PartsotheproductmaybederivedromBerkeleyBSDsystems,licensedromtheUniversityoCaliornia.UNIXisaregisteredtrademarkintheU.S.andothercountries,exclusivelylicensedthroughX/OpenCompany,Ltd.Sun,SunMicrosystems,theSunlogo,theSolarislogo,theJavaCofeeCuplogo,docs.sun.com,Java,andSolarisaretrademarksorregisteredtrademarksoSunMicrosystems,Inc.intheU.S.andothercountries.AllSPARCtrademarksareusedunderlicenseandaretrademarksorregisteredtrademarksoSPARCInternational,Inc.intheU.S.andothercountries.ProductsbearingSPARCtrademarksarebaseduponanarchitecturedevelopedbySunMicrosystems,Inc.TheOPENLOOKandSun TM GraphicalUserInteracewasdevelopedbySunMicrosystems,Inc.oritsusersandlicensees.SunacknowledgesthepioneeringefortsoXeroxinresearchinganddevelopingtheconceptovisualorgraphicaluserinteracesorthecomputerindustry.Sunholdsanon-exclusivelicenseromXeroxtotheXeroxGraphicalUserInterace,whichlicensealsocoversSun'slicenseeswhoimplementOPENLOOKGUIsandotherwisecomplywithSun'swrittenlicenseagreements.ProductscoveredbyandinormationcontainedinthispublicationarecontrolledbyU.S.ExportControllawsandmaybesubjecttotheexportorimportlawsinothercountries.Nuclear,missile,chemicalorbiologicalweaponsornuclearmaritimeendusesorendusers,whetherdirectorindirect,arestrictlyprohibited.ExportorreexporttocountriessubjecttoU.S.embargoortoentitiesidentiedonU.S.exportexclusionlists,including,butnotlimitedto,thedeniedpersonsandspecially designatednationalslistsisstrictlyprohibited.DOCUMENTATIONISPROVIDED“ASIS”ANDALLEXPRESSORIMPLIEDCONDITIONS,REPRESENTATIONSANDWARRANTIES,INCLUDINGANYIMPLIEDWARRANTYOFMERCHANTABILITY,FITNESSFORAPARTICULARPURPOSEORNON-INFRINGEMENT,AREDISCLAIMED,EXCEPTTOTHEEXTENTTHATSUCHDISCLAIMERSAREHELDTOBELEGALLYINVALID. 090416@21990  Contents UsingtheHTTPBindingComponent .................................................................................................5AbouttheHTTPBindingComponent ................................................................................................6HTTP/SOAPBindingArchitecture .....................................................................................................6HTTPBindingComponentFeatures ...................................................................................................8ServiceProviderFeatures ......................................................................................................................8ServiceConsumerFeatures ...................................................................................................................9SecurityFeatures .....................................................................................................................................9HTTPBindingComponentExampleScenario ..................................................................................9PurchaseOrderExample ...............................................................................................................9SOAPProcessing ................................................................................................................................. 11SOAP1.1WSDLExtensibilityElements .......................................................................................... 12SOAP1.1ConnectivityElement ................................................................................................ 12SOAP1.1BindingElements ....................................................................................................... 12SOAP1.2WSDLExtensibilityElements .......................................................................................... 19SOAP1.2ConnectivityElement ................................................................................................ 19SOAP1.2BindingElements ....................................................................................................... 20WS-IBasicProle1.1 .......................................................................................................................... 30HTTPProcessing ................................................................................................................................. 30HTTPWSDLExtensibilityElements ................................................................................................ 30HTTPConnectivityElement ...................................................................................................... 30HTTPBindingElements ............................................................................................................. 31HTTPGETandPOSTProcessing ..................................................................................................... 34XML/HTTPGETProcessing ............................................................................................................. 34ConguringtheHTTPBindingComponentorHTTPGetInteractions ............................ 34BindingDetails ............................................................................................................................. 35UsingtheHTTPBindingComponentwiththeHTTPPOSTMethod......................................... 38ConguringtheHTTPBindingComponentorHTTPGetInteractions ............................ 38BindingDetails ............................................................................................................................. 39 3  HTTPPOSTTreatmentohttp:urlEncodedandhttp:urlReplacement ............................... 39HTTPBindingComponentRuntimeProperties ............................................................................ 40UsingNormalizedMessagePropertiestoPropagateBindingContextInormation .................. 46UsingNormalizedMessagePropertiesinaBPELProcess ...................................................... 46NormalizedMessageProperties ................................................................................................. 53QualityoService(QOS)Features..................................................................................................... 55ConguringtheQualityoServiceProperties .......................................................................... 56MessageThrottling:ConguringandUsing ............................................................................ 58Redelivery:ConguringandUsing ........................................................................................... 59UsingtheTangoWebServiceFeatureswiththeHTTPBindingComponent ............................ 61ConguringReliableMessageDelivery .................................................................................... 62ConguringtheTangoWebServicesAttributesexposedbytheHTTPBindingComponent . 63AccessingtheTango(WSIT)WebServiceAttributeConguration ..................................... 63ServerConguration—WebServiceAttributes ....................................................................... 64ClientConguration—WebServiceAttributes...................................................................... 72HTTPBindingComponentSecurity ................................................................................................ 79UsingBasicAuthenticationwiththeHTTPBindingComponent ........................................ 79ConguringSecurityMechanisms ............................................................................................ 83UsingApplicationVariablestoDeneName/ValuePairs ...........................................................109UsingApplicationVariablesorpasswordprotection ..........................................................111UsingApplicationCongurationtoCongureConnectivityParameters ................................112 ▼ ToapplyanamedCongExtensiontotheApplicationConguration...............................112EnhancedLogging .............................................................................................................................113StatisticsMonitoring .........................................................................................................................113UsingWS-Transaction .....................................................................................................................114ClusteringSupportortheHTTPBindingComponent ...............................................................114HTTPLoadBalancer .................................................................................................................115ConguringtheHTTPBindingComponentorClustering ................................................115CommonUserScenarios ..................................................................................................................117ValidatingHTTPExtensibilityElementsromtheWSDLEditor .......................................117AddingaSOAPTemplatetoaWSDLDocument ..................................................................117AddinganHTTPTemplatetoaWSDLDocument ...............................................................118WebServiceClientCallinganOperationUsingHTTPBasicAuthentication ..................119WebServiceImplementinganOperationProtectedbyHTTPBasicAuthentication ......119WebServiceClientCallinganOperationUsingSSLAuthentication .................................120WebServiceImplementsanOperationProtectedbySSLAuthentication .........................121 ContentsUsingtheHTTPBindingComponent ã December20084