Manejo de datos binarios con Axis2 (masa máxima de despegue / SWA) Contenido Introducción A pesar de la flexibilidad, interoperabilidad y aceptación global de XML, hay momentos en que la serialización de datos en XML, no tiene sentido. usuarios de servicios Web pueden querer transmitir adjuntos binarios de diversos géneros como imágenes, dibujos, documentos XML, etc., junto con un mensaje SOAP. Este tipo de datos es a menudo en un formato binario en particular. Tradicionalmente, dos técnicas se han utilizado en el tratamiento de datos opacos en XML El envío de datos binarios por valor se logra mediante la incorporación de datos opacos (por supuesto después de alguna forma de codificación) como un elemento o atributo contenido del componente XML de los datos. La principal ventaja de esta técnica es que proporciona a las aplicaciones la capacidad de procesar y describir los datos, basándose únicamente en el componente XML de los datos. XML es compatible con los datos opacos como el contenido mediante el uso de cualquiera de base 64 o la codificación de texto hexadecimal. Ambas técnicas hinchan el tamaño de los datos. Para codificación UTF-8 texto subyacente, la codificación base64 aumenta el tamaño de los datos binarios en un factor de 1.33x del tamaño original, mientras que la codificación hexadecimal de datos se expande en un factor de 2x. Los factores anteriores se duplicará si se utiliza texto UTF-16. Es también preocupante la sobrecarga en los costos de procesamiento (tanto reales como imaginarios) para estos formatos, especialmente cuando se decodifica de nuevo en binario. El envío de datos binarios por referencia se consigue uniendo los datos binarios puros como entidades no analizadas generales exteriores fuera del documento XML y luego incrustar URI referencia a aquellas entidades como elementos o valores de atributos. Esto evita la hinchazón innecesaria de datos y pérdida de potencia de procesamiento. El principal obstáculo para el uso de estas entidades no analizadas es su fuerte dependencia de las DTD, lo que impide la modularidad, así como el uso de espacios de nombres XML. Había varias especificaciones introducidas en el mundo de servicios Web para hacer frente a este problema adjunto binario usando la técnica referencequot quotby. SOAP con archivos adjuntos es un ejemplo de ello. Desde JABÓN prohíbe declaraciones de tipo de documento (DTD) en los mensajes, esto nos lleva al problema de no representar los datos como parte del conjunto de información de mensajes, por lo tanto, la creación de dos modelos de datos. Este escenario es como enviar archivos adjuntos con un mensaje de correo electrónico. A pesar de que los archivos adjuntos están relacionados con el contenido del mensaje que no están dentro del mensaje. Esto hace que las tecnologías que procesan y describen los datos basados en el componente XML de los datos a un mal funcionamiento. Un ejemplo es WS-Security. ¿De dónde viene masa máxima de despegue En masa máxima de despegue (mensaje SOAP de Transmisión Mecanismo Optimization) es otra especificación que se centra en la solución del problema quotAttachmentsquot. MTOM trata de aprovechar las ventajas de las dos técnicas anteriores, tratando de combinar las dos técnicas. Masa máxima de despegue es en realidad un método quotby referencequot. El formato de alambre de un mensaje MTOM optimizado es el mismo que el mensaje SOAP con archivos adjuntos, que también hace que sea compatible con los criterios de valoración SwA. La característica más notable de la masa máxima de despegue es el uso de la XOP: elemento, que se define en la especificación XML binario Empaquetado Optimizado (XOP) para hacer referencia a los adjuntos binarios (entidades no analizadas generales externos) del mensaje Incluir. Con el uso de este elemento exclusivo, el contenido binario adjunto se convierte lógicamente en línea (por valor) con el documento de SOAP a pesar de que en realidad se adjunta por separado. Esto combina los dos reinos por lo que es posible trabajar sólo con un modelo de datos. Esto permite que las aplicaciones para procesar y describen con sólo mirar la parte XML, por lo que la dependencia de los DTDs obsoleto. En una nota más ligera, masa máxima de despegue ha estandarizado el mecanismo de referencia de SwA. El siguiente es un extracto de la especificación XOP. En el plano conceptual, estos datos binarios pueden ser considerados como siendo codificado en base 64 en el documento XML. Como podría ser necesaria esta forma conceptual durante algún procesamiento del documento XML (por ejemplo, para la firma del documento XML), es necesario tener una correspondencia uno a uno entre los conjuntos de información XML y Paquetes XOP. Por lo tanto, la representación conceptual de tales datos binarios es como si estuviera codificado base 64, utilizando la forma léxica canónica del tipo de datos de esquema XML base64Binary (ver Esquema XML Parte 2: Tipos de datos Segunda edición 3.2.16 base64Binary). En la dirección inversa, XOP es capaz de optimizar sólo los datos Infoset codificado en base 64 que está en la forma léxica canónica. Apache Axis2 es compatible con la codificación Base64. SOAP con archivos adjuntos y masa máxima de despegue (mensaje SOAP de Transmisión Mecanismo de Optimización). Masa máxima de despegue con Axis2 modelo de programación axioma es (y puede ser el primero) Modelo de objetos que tiene la capacidad de almacenar datos binarios. Tiene esta capacidad como OMText puede contener contenido binario en bruto en forma de javax. activation. DataHandler. OMText ha sido elegido para este fin con dos razones. Una es que XOP (MTOM) es capaz de optimizar único dato conjunto de información codificado en base 64 que está en la forma léxica canónica de esquema XML base64Binary tipo de datos. Otro es para preservar el conjunto de información, tanto en el emisor y el receptor. (Para almacenar el contenido binario en el mismo tipo de objeto, independientemente de si está optimizado o no). MTOM permite codificar selectivamente partes del mensaje, lo que nos permite enviar los datos base64encoded así como datos binarios sin conectados externamente los que hace referencia el elemento quotXOPquot (contenido optimizado) para ser enviados en un mensaje SOAP. Puede especificar si un nodo OMText que contiene datos binarios en bruto o datos binarios base64encoded está calificado para ser optimizado en el momento de la construcción de ese nodo o posterior. Para una eficacia óptima de la masa máxima de despegue, se aconseja a los usuarios enviar archivos adjuntos binarios más pequeños usando base64encoding (no optimizado) y los archivos adjuntos de mayor tamaño como contenido optimizado. Además, un usuario puede crear un nodo de contenido binario optimizable mediante una cadena base64, que contiene el contenido binario codificado, dada con el tipo MIME de la representación binaria real. Axis2 utiliza javax. activation. DataHandler para manejar los datos binarios. Todos los nodos de contenido binarios optimizados serán serializados como base 64 cadenas si no se quotMTOM enabledquot. También puede crear nodos de contenido binario, que no será optimizado en cualquier caso. Ellos serán serializados y enviados como base 64 Cuerdas. Permitiendo la optimización masa máxima de despegue en el cliente En Opciones, establezca la propiedad en True quotenableMTOMquot al enviar mensajes. Cuando esta propiedad se establece en True, cualquier sobre SOAP, independientemente de si se incluye contenido optimizable o no, va a ser serializado como un mensaje MIME MTOM optimizado. Axis2 serializa todos los nodos de contenido binario codificado como base 64 cadenas independientemente de si ellos están calificados para ser optimizado o no si la propiedad quotenableMTOMquot se establece en False. si el sobre contiene ningún artículo de información de elemento del nombre xop: Incluir (ver XML-binario Empaquetado Optimizado 3. XOP InfoSets Las construcciones). El usuario no tiene que especificar nada con el fin de Axis2 para recibir mensajes MTOM optimizado. Axis2 identificará automáticamente y de-serializar en consecuencia, como y cuando llega un mensaje de masa máxima de despegue. Permitiendo la optimización masa máxima de despegue en el lado del servidor El servidor Eje 2 identifica automáticamente los mensajes entrantes MTOM optimizado basado en el tipo de contenido y los de-serializa en consecuencia. El usuario puede enableMTOM en el lado del servidor para los mensajes salientes, Para enableMTOM a nivel mundial para todos los servicios, los usuarios pueden establecer el parámetro quotenableMTOMquot en True en el axis2.xml. Cuando se establece, todos los mensajes salientes serán serializados y enviados como MTOM optimizado mensajes MIME. Si no se establece, todos los datos binarios en los nodos de contenido binarios serán serializados como cadenas Base64 codificados. Esta configuración se puede overriden en services. xml sobre la base de por servicio y por operación. Debe reiniciar el servidor después de ajustar este parámetro. Accediendo recibidos datos binarios (Código de ejemplo) Algunos valores Content-Transfer-Encoding no son compatibles con Multiparts En la documentación de JAX-RS He leído lo siguiente: Al manejar presentaciones multipart / form-data complejos (como los archivos que contienen) MultipartBody (y adjunto) necesita ser utilizado directamente. En los casos más simples, cuando cada parte forma puede ser capturado por cadena, el siguiente código es suficiente: Consume la POST (multipart / form-data) public void addForm1 (título FormParam (nombre) de cadena, FormParam (id) de largo id) throws Exception. Este puede ser un error en CXF o una documentación engañosa (por lo menos para los hablantes no nativos lenta-mente como yo). La gran diferencia entre FormParam y multiparte es, que FormParam siempre espera que los datos codificados en la URL. Por lo tanto el envío de AB usando varias partes, por ejemplo en 8 bits de codificación o codificación binaria entrega un B a FormData anotado Cuerdas pero AB para Cuerdas de varias partes anotadas. Actividad Andreas, yo creo que es en realidad el hecho de que (cuerda) los valores multipart / form-data simples no fueron decodificados por defecto cuando se utilizaron varias partes, que causó que abre la cuestión de errores. He actualizado el código de modo por defecto, dado AB, obtendrá A B pero la decodificación automática (igual que cuando se utiliza FormParam) se pueden desactivar mediante la adición de una anotación codificado. Tenga en cuenta que es poco probable que los FormParams lleguen a utilizarse en las futuras especificaciones para el manejo de JAXRS Multiparts, therere limitado en que no se puede especificar un tipo de contenido de la parte individual, etc Sergey Beryozkin añadió un comentario - 16 / Mar / 10 14:07 Andreas, yo creo que es en realidad el hecho de que (cuerda) los valores multipart / form-data simples no fueron decodificados por defecto cuando se utilizaron varias partes, que causó que abre la cuestión de errores. He actualizado el código de modo por defecto, dado AB, obtendrá A B pero la decodificación automática (igual que cuando se utiliza FormParam) se pueden desactivar mediante la adición de una anotación codificado. Tenga en cuenta que se trata de FormParams poco probable que los lleguen a utilizarse en las futuras especificaciones de JAXRS para el manejo de Multiparts, therere limitado en que no se puede especificar un tipo de contenido de la parte individual, etc. Entiendo que url-codificación es el valor predeterminado para FormParam, porque hay en realidad no hay otra manera para una URL codificada formas para codificar parámetros. Por lo tanto, tiene sentido dejar FormParam decodificar los datos de esta forma. Pero los datos de varias partes se pueden codificar de varias maneras. La codificación de la parte de varias partes se pueden leer los datos y se puede decodificar de forma automática la forma correcta. Lo que se espera de CXF es, que descodifica los datos de la forma correcta y luego simplemente lo inyecta en mi parámetro sin que tenga que especificar una codificación. En realidad no quiero especificar la codificación, porque no me importa cómo los datos se transporta a mí. Quiero que mi función es eficaz para los datos de varias partes que se codifica como una cadena de 8 bits, así como QP (siempre y cuando tenga sentido), de manera que la persona que llama de la función sólo tiene que saber, que él tiene que usar encofrado multiparte datos. ¿Es esto posible Andreas Sahlbach añadió un comentario - 16 / Mar / 10 16:42 entiendo que url-codificación es el valor predeterminado para FormParam, porque en realidad no hay otra manera para una URL codificada formas para codificar parámetros. Por lo tanto, tiene sentido dejar FormParam decodificar los datos de esta forma. Pero los datos de varias partes se pueden codificar de varias maneras. La codificación de la parte de varias partes se pueden leer los datos y se puede decodificar de forma automática la forma correcta. Lo que se espera de CXF es, que descodifica los datos de la forma correcta y luego simplemente lo inyecta en mi parámetro sin que tenga que especificar una codificación. En realidad no quiero especificar la codificación, porque no me importa cómo los datos se transporta a mí. Quiero que mi función es eficaz para los datos de varias partes que se codifica como una cadena de 8 bits, así como QP (siempre y cuando tenga sentido), de manera que la persona que llama de la función sólo tiene que saber, que él tiene que usar encofrado multiparte datos. Se possibleFollowing este contenido se ha capturado en tcpmon: Solicitud procedente de soapUI Pro 3.0.2: Mensaje / f6 / servicios / xdsrepositoryb HTTP / 1.1 Accept-Encoding: gzip, desinfle Content-Type: multipart / relacionados typeapplication / xopxml iniciar la puesta en infoapplication / soapxml límite acción ---- Part1728349551.1260534830078 MIME-Version: 1.0 User-Agent: Jakarta Commons-HttpClient / 3.1 Host: ihexds. nist. gov:9080 Content-Length: 13318 ------ contenido Part1728349551.1260534830078 de tipo: application / xopxml charsetUTF-8 typeapplication / soapxml actionProvideAndRegisterDocumentSetRequest Content-Transfer-Encoding: 8bit Content-ID: ------ Part1728349551.1260534830078 Content-Type: text / plain charsetus-ascii Content-Transfer-Encoding: 7bit Content-ID: ltgt Esta es Depeches documento. Petición realizada por la herramienta xdstest: Mensaje / f6 / servicios / xdsrepositoryb HTTP / 1.1 Content-Type: multipart / relacionados con boundaryMIMEBoundaryurnuuid613A2BD2D99F1E6B5912 60534073176 typeapplication / xopxml startlt0.urn: uuid: 613A2BD2D99F1E6B591260534073177 apache. orggt de puesta en infoapplication / soapxml actionurn: IHE: ITI: 2007 rovideAndRegisterDocumentSet b-User-Agent: Axis2 anfitrión: ihexds. nist. gov:9080 Transfer-Encoding: fragmentada 20f1 --MIMEBoundaryurnuuid613A2BD2D99F1E6B59126053407 3176 Content-Type: application / xopxml charsetUTF-8 typeapplication / soapxml Content-Transfer-Encoding: binary Content-ID : lt0.urn: uuid: 613A2BD2D99F1E6B591260534073177apache. orggt --MIMEBoundaryurnuuid613A2BD2D99F1E6B59126053407 3176 Content-Type: text / plain Content-Transfer-Encoding: binary Content-ID: LT1. urn: uuid: 613A2BD2D99F1E6B591260534073366apache. or g gt Esta es mi documento. De donde puedo configurar Content-Transfer-Encoding como binarios en el Registro Público NIST, puede ver el documento de texto que se ha enviado como un archivo adjunto: También he intentado hacer Adjuntos Codificar como verdadero en Propiedades TestRequest. Pero no su trabajo tampoco. Gracias por la matriz de bytes en helpConvert base64Binary En respuesta a esta entrada mediante robbywillz El martes 16 de agosto de, 2011 11:28:43 PM robbywillz escribió: Hola GT, GT gt Muchas gracias por proporcionar diferentes maneras de activar o desactivar la masa máxima de despegue. gt pude capaz de tener una base64Binary en línea mediante la desactivación de la masa máxima de despegue y gt aumentar el umbral de masa máxima de despegue (1024). gt entendí que MTOM se habilitará para la unión al umbral es gt cruzados, incluso a través de masa máxima de despegue está deshabilitado. Por favor, corríjanme si estoy equivocado. gt gt ¿Hay alguna manera de configurar a través de la configuración del cliente de primavera Que te gt quiero hacer esto cambia en WSDL o en código como el código se puede ejecutar en Websphere v6.1 gt con los servicios web ofrecen instalado el paquete. Si ése es el caso, yo en realidad sugeriría hacerlo en el código, pero con los estándares API JAX-WS. De esta manera, debe comportarse de la misma para cualquiera de los diversos proveedores de JAX-WS. Al crear su cliente, pasar un objeto javax. xml. ws. soap. MTOMFeature que está configurado para apagar masa máxima de despegue o establecer el umbral. Todos los métodos createXXXPort tienen un conjunto opcional de características que se pueden pasar en al crear tiempo. Utilizar esos métodos con el MTOMFeature y debería funcionar para WebSphere también. gt gt He intentado con la siguiente configuración y el nombre de archivo como cxf. xml, es gt recogido por cxf pero ningún efecto sobre la configuración. Todavía se convierte en gt XOP. Por favor, ayúdame gt gt ltxml versionquot1.0quot encodingquotUTF-8quotgt gt ltbeans xmlnsquotwww. springframework. org/schema/beans quot gt xmlns: jaxwsquotcxf. apache. org/jaxws quot gt xmlns: xsiquotwww. w3.org/2001/XMLSchema-instance quot gt xsi: schemaLocationquot gt gt www. springframework. org/schema/beans www. springframework. org/schema/beans/spring-beans. xsd gt gt cxf. apache. org/jaxws cxf. apache. org/schemas/jaxws. xsd quotgt gt gt gt ltjaxws: cliente idquotne3sRegistrationquot gt gt serviceClassquotcom. nsn. oss. ne3s. ws. gen. NE3SRegistrationPortquot addressquot / NE3SRegistrationServicequotgt gt ltjaxws: propertiesgt gt ltentry keyquotmtom-enabledquot valuequotfalsequot / gt gt ltentry keyquotmtom-thresholdquot valuequot1024quot / gt gt lt / jaxws : propertiesgt gt lt / jaxws: clientgt gt lt / beansgt gt El Miércoles 24 Agos 2011 a las 2:09, Daniel Kulp a través de correo electrónico CXF lthidden gt escribió: El martes 16 de agosto de, 2011 11:28:43 PM escribió robbywillz : gt Hola, gt gt muchas gracias por proporcionar diferentes maneras de activar o desactivar la masa máxima de despegue. gt pude capaz de tener una base64Binary en línea mediante la desactivación de la masa máxima de despegue y gt aumentar el umbral de masa máxima de despegue (1024). gt entendí que MTOM se habilitará para la unión al umbral es gt cruzados, incluso a través de masa máxima de despegue está deshabilitado. Por favor, corríjanme si i39m mal. gt gt ¿Hay alguna manera de configurar a través de la configuración del cliente de primavera me don39t gt quiero hacer esto cambia en WSDL o en código como el código se puede ejecutar en Websphere v6.1 gt con los servicios web ofrecen instalado el paquete. Si that39s el caso, no me habría importado sugeriría hacerlo en el código, pero con los estándares API39s JAX-WS. De esta manera, debe comportarse de la misma para cualquiera de los diversos proveedores de JAX-WS. Al crear su cliente, pasar un objeto javax. xml. ws. soap. MTOMFeature que está configurado para apagar masa máxima de despegue o establecer el umbral. Todos los métodos createXXXPort tienen un conjunto opcional de características que se pueden pasar en al crear tiempo. Utilizar esos métodos con el MTOMFeature y debería funcionar para WebSphere también. gt I39ve trató con configuración siguiente y me nombró archivo como cxf. xml, es gt cxf. apache. org/schemas/jaxws. xsd quotgt gt gt gt ltjaxws: idquotne3sRegistrationquot cliente gt serviceClassquotcom. nsn. oss. ne3s. ws. gen. NE3SRegistrationPortquot gt addressquot / NE3SRegistrationServicequotgt gt ltjaxws: propertiesgt gt ltentry keyquotmtom-enabledquot valuequotfalsequot / gt gt ltentry keyquotmtom-thresholdquot valuequot1024quot / gt gt lt / jaxws: propertiesgt gt lt / jaxws: clientgt gt lt / beansgt gt Si responde a este correo electrónico, su mensaje será añadido a la discusión a continuación: enviar archivos adjuntos con aplicaciones SOAP a menudo tienen que hacer frente a más de mensajes simples. La carga útil de un mensaje SOAP a menudo puede incluir un procesador de textos o documentos PDF, imagen, u otro archivo binario. En este artículo se explica cómo utilizar el Mecanismo de Optimización de Transmisión de mensajes (MTOM) para enviar y recibir estos mensajes. Descargar esta guía gratuita Manual libre: Java desarrollo de aplicaciones en la nube los ingenieros de software se están acercando desarrollo y el diseño de la empresa de una forma completamente nueva, gracias a la nube. En este manual experto, exploran cómo sus colegas están aprovechando la nube para optimizar la administración del ciclo de vida de aplicaciones, ahorrar dinero, y hacer que la producción y la seguridad más eficiente. Al enviar su dirección de correo electrónico, usted acepta recibir correos electrónicos sobre ofertas de temas relevantes de TechTarget y sus socios. Usted puede retirar su consentimiento en cualquier momento. Póngase en contacto con TechTarget a 275 Grove Street, Newton, MA. También acepta que su información personal puede ser transferida y procesada en los Estados Unidos, y que ha leído y acepta las condiciones de uso y la política de privacidad. Requisitos previos En este artículo se utiliza la WSO2 Servicios Web Application Server (WSAS.) Se recomienda que descargue e instale WSO2 WSAS 2.0. El artículo utiliza la edición del servlet instalado en Apache Tomcat. Cualquier servidor de aplicaciones se puede utilizar con la versión de servlet, sólo tienes que seguir las instrucciones de instalación incluidas con WSO2 WSAS. Usted no tiene que utilizar un servidor de aplicaciones para nada, ya que funciona WSO2 WSAS grande en un formato independiente. WSO2 WSAS requiere Java 1.4 o 1.5, pero no hay otros requisitos previos para ello. Por supuesto, los servicios web y jabón, especialmente se utiliza, por lo que la familiaridad con que le ayudarán. Cuando XML no es suficiente: datos binarios Hay un sinfín de maneras de enviar datos por la red. Hay numerosos protocolos y formatos de datos. Normalización alrededor de SOAP ha quitado una gran cantidad de las conjeturas en el envío de datos entre sistemas. JABÓN estandariza el protocolo (HTTP) y el formato de datos (XML). Una de las principales críticas de jabón es el uso de XML. XML está basado en texto. Esto no sólo hace para mensajes de gran tamaño, pero hace que sea incompatible con datos binarios. Por ejemplo, digamos que su mensaje debe incluir una imagen. Esto plantea un problema cuando el formato de mensaje es texto. La combinación de datos binarios con jabón Ok, por lo que necesita para enviar datos binarios entre aplicaciones. Youd como para utilizar el jabón, pero su limitado al texto. Así que en caso de que acaba de renunciar a todos juntos de SOAP Por supuesto que no hay demasiadas ventajas a SOAP. Sólo se necesita una manera de combinarlos con datos binarios. Usted ve las páginas web hacen esto todo el tiempo que no puede ser tan difícil, ¿verdad Vamos a explorar algunas soluciones a este problema. Una forma es posible intentar es simplemente volcar el binario en un nodo de texto. Podría ser algo como el Listado 1. Listado 1. XML con datos binarios: primer intento Recuerde que los personajes son también bytes, al igual que los datos binarios. Un analizador XML, si es un analizador DOM, SAX, o StAX, debe utilizar el juego de caracteres de codificación del documento de interpretar todos los bytes en el documento como caracteres. Así que nuestros datos binarios podrían fácilmente tener caracteres que corresponden a caracteres XML reservados, como LT o GT o amplificador. Cualquier secuencia de bytes en nodo de texto anterior hará que el analizador en el otro lado se rompa. Así que este enfoque no funcionará. Pero, un momento, tal vez theres una manera de solucionar este enfoque. ¿Qué pasa con el uso de un bloque CDATA que le dirá el analizador de hacer caso omiso de los personajes dentro del bloque. Este enfoque modificado puede tener un aspecto similar al del listado 2. Listado 2. XML con Binario: Usando CDATA Ahora bien, si tenemos bytes que se interpretarían como un GT (por ejemplo,), serán ignoradas. Sin embargo, el analizador tiene que averiguar dónde termina la sección CDATA. Esto se hace mediante la búsqueda de la secuencia de bytes que corresponde a la gt caracteres. Puede parecer poco probable, pero nuestros datos binarios podría tener sólo una secuencia de este tipo byte en el centro de la misma. Eso haría que cualquier programa de análisis para pensar que la sección CDATA había terminado y los caracteres subsiguientes se interpretaría al igual que en nuestro primer intento. Así que eso no es ir a trabajar tampoco. Necesitamos una forma de asegurarse de que esos bytes enviaban interpretarse en absoluto. Codificación base 64: Obras hinchada pero hay una solución a esta variante de nuestro problema. Una forma común de hacer esto es usar codificación Base 64. Esta técnica ha sido de alrededor (como estándar) desde los años 80. Implica el uso de un alfabeto de 64 caracteres que consta de los caracteres en minúscula, a-z, los caracteres en mayúsculas, A-Z, los números 0-9, y los símbolos y /. Cada byte se asigna a estos personajes, por lo que los theres ninguna manera por cualquier byte para obtener el mal interpretado como algo que pudiera ahogar un analizador XML. Así que hay, problema resuelto, a la derecha Sí, pero es una solución bastante ineficiente. Base 64 vientos binarios codificados a ser, en promedio, el 37 de mayor tamaño (número de bytes) de los datos binarios sin formato, no codificados. Además, el analizador en el otro lado necesita saber acerca de la codificación de manera que puede descodificar la carga útil. Uno podría imaginar que si la codificación Base 64 era parte del estándar SOAP, entonces no habría alguna forma estándar para indicar esta procesadores de mensajes SOAP. Este no es el caso, sin embargo. Puede ser una solución, pero es ineficiente y no estándar. Necesitamos algo que sea más eficiente y estandarizada. SOAP con archivos adjuntos: Funciona, pero el diseño defectuoso Una solución al problema es utilizar lo que se conoce como SOAP con archivos adjuntos. La idea aquí es que sólo hay que poner los datos binarios fuera del mensaje SOAP por completo. La Figura 1 proporciona una buena visualización de este. Figura 1. SOAP con Adjuntos Esto es muy similar a cómo los archivos binarios se pueden unir a los correos electrónicos. El mensaje SOAP contiene una referencia al archivo binario que se adjunta al mensaje. Esto es tanto más eficiente y estandarizada, pero tiene algunos defectos en su diseño. El archivo adjunto binario no es parte del mensaje SOAP en absoluto. Su similar en muchos aspectos a un URI de paso para los datos binarios y dejándolo hasta el procesador de mensajes para recuperar los datos binarios reales. Presenta algunos problemas reales para cosas como WS-Security. Aún así, esto es lo que se utilizó durante un tiempo, hasta que se ha propuesto una solución mejor: masa máxima de despegue. Masa máxima de despegue: Lo mejor de ambos mundos masa máxima de despegue es sinónimo de mensaje SOAP Mecanismo de Optimización de Transmisión. Combina la eficiencia de SOAP con archivos adjuntos, pero lo hace sin tener que romper los datos binarios fuera del mensaje SOAP. ¿Cómo puede ser esto La clave es una tecnología llamada Optimized Packaging XML-binario o XOP. XOP permite que los datos binarios para ser incluidos como parte del conjunto de información XML. De hecho, el conjunto de información XML se convierte en un superconjunto del conjunto de información tradicional conocido como el XOP conjunto de información. Se permite que los datos binarios que se almacenan fuera del documento XML, al igual que en SOAP con archivos adjuntos. Se utiliza un XOP especial: incluir elementos para decirle al procesador para sustituir el contenido con los datos binarios que se hace referencia, por tanto, que encapsula la lógica de almacenamiento y recuperación de los datos binarios discretos. Esta lógica se vuelve inherente al analizador XML, y permite que el analizador SOAP para el tratamiento de los datos binarios como parte del documento XML, sin una lógica de recuperación especial. Del mismo modo se permite un servidor SOAP para crear un mensaje SOAP de una manera uniforme, sin romper la lógica especial para que los datos binarios desde el mensaje SOAP. Masa máxima de despegue en WSO2 WSAS Hemos hablado mucho de la necesidad de una masa máxima de despegue y cómo debería funcionar en teoría. Nos doesnt hacer mucho bien sin una implementación real. Por suerte theres una manera fácil de conseguir una gran aplicación masa máxima de despegue, sólo tiene que utilizar WSO2 WSAS. WSO2 WSAS se construye en la parte superior de las tecnologías probadas y eficaces, incluyendo Apache Axis2. Axis2 da WSO2 WSAS su aplicación masa máxima de despegue. Vamos a echar un vistazo a cómo aprovechar el poder de aplicación WSAS / Axis2s masa máxima de despegue. Envío de un mensaje masa máxima de despegue de un servicio web con el apoyo de Axiom API masa máxima de despegue en Axis2 se basa en las mismas clases que se utilizan a lo largo de Axis2. Utiliza Axis2s modelo de objetos (OM). Axis2 es compatible tanto con la base 64 de codificación y masa máxima de despegue, y hace que sea relativamente sencillo para cambiar entre ellos. ¿Por qué Bueno para archivos muy pequeños, en realidad puede ser más eficaz utilizar codificación Base 64. Para lograr esta conmutación sin fisuras entre el transporte optimizado la no optimizado y, Axis2 trata los datos binarios como un nodo de texto XML. La única diferencia es que se necesita para pasar de una javax. activation. DataHandler para acceder a los datos, como se muestra en el Listado 3. Listado 3. Adición de datos binarios con la API de Axiom En el ejemplo en el Listado 3, un javax. activation. FileDataSource se utiliza para proporcionar la DataHandler con acceso a los datos binarios. Se puede utilizar cualquier clase que implementa la interfaz javax. activation. DataSource. Por ejemplo, cuando se trabaja con imágenes, el org. apache. axis2.attachments. ImageDataSource se puede utilizar. Se implementa la interfaz DataSource y puede ser más conveniente cuando se trabaja con imágenes. Entonces, ¿cómo lo hace Axis2, y por lo tanto WSO2 WSAS, sabe usar masa máxima de despegue para optimizar los datos binarios que es en realidad lo que Axis2 hará de forma predeterminada. Puede anular manualmente esto añadiendo una sola línea de código, como se muestra en el Listado 4. Listado 4. Desactivación de masa máxima de despegue Esa sola línea de código le dirá que no Axis2 optimizar, es decir, no lo utilizo de masa máxima de despegue. Por lo tanto Axis2 utilizará base 64 codificación de los datos binarios, y lo que realmente va a ser un nodo de texto. De lo contrario, entrará en funcionamiento masa máxima de despegue, y un XOP incluir serán utilizados para optimizar el transporte de los datos binarios en el mensaje SOAP. Habilitación de masa máxima de despegue en el servidor Por supuesto, para conseguir todo esto el comportamiento maravilloso, optimizado automáticamente, no necesita habilitar masa máxima de despegue. Usted puede hacer esto a través de su archivo axis2.xml muy fácilmente, como se muestra en el Listado 5. Listado 5. Habilitación de masa máxima de despegue en axis. xml No se puede conseguir más indolora que eso, bien Esta es una configuración global, y es la configuración predeterminada en WSO2 WSAS. En realidad se puede activar masa máxima de despegue en cuatro niveles diferentes: global, el grupo de servicio, servicio y operación. Se utiliza la misma semántica para cada nivel. Puede utilizar la consola de administración para gestionar masa máxima de despegue en cada uno de estos niveles. Por ejemplo de este echar un vistazo a la Figura 2. Figura 2. Administración de masa máxima de despegue en el grupo de nivel de servicio Aquí vemos masa máxima de despegue está gestionando a nivel del grupo de servicio. Cada servicio en el grupo también se puede gestionar de forma individual, como se muestra en la Figura 3. Figura 3. Gestión de masa máxima de despegue en el nivel de servicio Por supuesto, cada servicio puede tener una o más operaciones. WSAS le permite administrar masa máxima de despegue en ese nivel también, como se muestra en la Figura 4. Tenga en cuenta que en cada nivel, masa máxima de despegue tiene tres valores posibles: verdadero, falso, y opcionales. Si la propiedad se establece en true, entonces el servicio enviará un mensaje optimizado cuando sea necesario, es decir, cuando se incluye datos binarios. Si el valor se establece en falso, entonces optimización nunca será utilizada, y la Base 64 de codificación será utilizado para los datos binarios. Si se establece en opcional, a continuación, WSAS optimizará si y sólo si la solicitud de vino se ha optimizado. El tipo de solicitud indicará a WSAS si se debe utilizar o no MTOM. ¿Por qué necesitamos este tipo de flexibilidad Como se mencionó anteriormente, a menudo es ventajoso usar base 64 codificación de archivos pequeños. Por lo tanto usted podría decidir que ciertas operaciones deben usar masa máxima de despegue y otros no deberían hacerlo. O bien, podría hacer que sea opcional en una operación, programación hacer un cheque por el tamaño de los datos que están siendo enviados, y luego optar por anular la masa máxima de despegue por defecto si el archivo es pequeño. Entonces usted está enviando masa máxima de despegue. Vamos a echar un vistazo a lo fácil WSAS hace que enviar un mensaje de masa máxima de despegue desde un cliente de servicios web. Creación de un cliente SOAP que envía mensajes de masa máxima de despegue Envío de un mensaje masa máxima de despegue de un cliente es tan fácil como enviar un mensaje de masa máxima de despegue de un servicio Web. Axis2 proporciona varias APIs convenientes. Un ejemplo se muestra en el Listado 6. Listado 6. código de cliente para enviar el mensaje de masa máxima de despegue Como se puede ver en el Listado 6, la clave para hacerlo es permitir masa máxima de despegue en las opciones para el cliente de servicios web. Una vez hecho esto, entonces Axis2 optimizará cualquier dato binario se envía al servicio web utilizando masa máxima de despegue de forma automática. Hemos visto cómo enviar mensajes de masa máxima de despegue de un servicio Web y para un servicio web, ahora veamos cómo trabajar con los datos que se han enviado a través de masa máxima de despegue. Manejo de una masa máxima de despegue mensaje en un servicio Web Ahora vamos a suponer que usted tiene un servicio web que acepta datos binarios como parte de un mensaje SOAP de un cliente. Si el servicio Web se ejecuta en WSAS, ya no tienes que hacer nada especial para ser capaz de manejar datos binarios optimizados de sus clientes. Sus clientes pueden enviar mensajes SOAP que utilizan masa máxima de despegue o de base 64 codificación. Su todo sin fisuras con WSAS. Listado 7 muestra un ejemplo de recepción de datos optimizados. Listado 7. servicio web SOAP de recibir optimizada como hemos visto anteriormente, la API de Axiom trata los datos binarios como un nodo de texto. Esto permite que una sola API para trabajar con datos optimizado y no optimizado (Base 64 codificado). Sólo tiene que acceder a la DataHandler asociado al nodo de texto (que contiene los datos binarios) y el uso que para obtener un InputStream. Una vez que tenga el InputStream, se puede leer todos los bytes y procesarlos sin embargo es necesario. WSAS hace que sea fácil de manejar mensajes SOAP con cargas de datos binarios optimizados. Vamos a echar un vistazo a lo fácil que es trabajar con masa máxima de despegue en los clientes. Manejo de una masa máxima de despegue mensaje en un cliente aquí no hay ningún mágica para manejar una respuesta del servicio web masa máxima de despegue. Hemos visto ya cómo configurar la solicitud. En la Figura 8 se ve cómo tratar con una respuesta que contiene datos binarios optimizados con masa máxima de despegue. Una vez más la clave aquí es utilizar la API de Axiom. Nos permite tratar los datos binarios como un nodo de texto, y luego usar el DataHandler para obtener un InputStream a los datos. Una vez más, una vez que tenga el InputStream, puede procesar los datos sin embargo es necesario. Resumen Hemos visto cómo MTOM ofrece la combinación perfecta de la normalización y la eficiencia de SOAP para transportar datos binarios dentro de un mensaje de servicio web. Hemos visto cómo WSO2 WSAS implementa la especificación de masa máxima de despegue usando Axis2. Hemos tomado un vistazo a cómo configurar ambos servidores y clientes de servicios de Internet para enviar y recibir mensajes MTOM optimizado. Ahora tenemos todo lo que necesitamos para la adición de datos binarios a nuestros servicios web usando WSO2 WSAS. Recursos que usted va a querer descargar WSO2 WSAS. Lea sobre las últimas funciones en WSO2 WSAS 2.0. Aprender e interactuar con la comunidad de WSO2 en el WSAS Wiki. Obtener información acerca de la exposición de sus servicios como servicios web fácilmente con Axis2. Aprender cómo Axis2 puede permitir a sus diseños en el SOA SOA developerWorks artículo con Axis2. Aprende todo sobre la interoperabilidad con otras implementaciones Eje de servicios Web en esta entrada en el blog TSS Interoperabilidad. Sumergirse en el API AXIOM en el artículo de developerWorks Obtener el máximo rendimiento de procesamiento de XML con el axioma. Lea todo sobre XOP y masa máxima de despegue en esta entrada del blog de Mark Nottingham. La interoperabilidad es el nombre del juego cuando se trata de servicio web, por lo que aprender sobre el uso de masa máxima de despegue con el artículo El envío de archivos en trozos con masa máxima de despegue Servicios Web y 2.0. Sobre el autor Michael Galpin es un arquitecto en eBay en San Jose, CA. Hes estado desarrollando software desde 1998, y tiene un título en matemáticas en el Instituto de Tecnología de California.
No comments:
Post a Comment