R语言 SSOAP包 writeSOAP()函数中文帮助文档(中英文对照)

loveR

writeSOAP(SSOAP)
writeSOAP()所属R语言包：SSOAP

                                        Write SOAP message elements directly to connection
                                         编写SOAP消息元素直接连接

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

These functions write the different parts of the SOAP request directly to an S connection. This means that they generate their content for the connection in order.
这些功能编写的SOAP请求的不同部分，直接的连接。这意味着，他们为了连接生成其内容。


用法----------Usage----------


writeSOAPBody(method, ..., xmlns = NULL, con, .types = NULL,
              .soapArgs = list(), .literal = FALSE,
              .header = NULL, .elementFormQualified = FALSE)
writeSOAPEnvelope(con, nameSpaces = SOAPNameSpaces())

writeSOAPMessage(con, nameSpaces, method, ..., .types = NULL,
                    xmlns = NULL, .soapArgs = list(), .literal = FALSE,
                     .soapHeader = NULL, .elementFormQualified = FALSE)



参数----------Arguments----------

参数：method
the name of the SOAP method to be invoked
被调用SOAP方法的名称


参数：...
For writeSOAPBody and writeSOAPMessage, these are the name-value arguments for the SOAP method being called.   
writeSOAPBody和writeSOAPMessage，这些都为SOAP方法的名称 - 值参数被称为。


参数：.soapArgs
an alternative mechanism for passing arguments to the .SOAP call. This is a list of named or unnamed values which is used as the arguments for the SOAP method invocation.   
一个参数传递给SOAP调用的替代机制。这是一个list的有名或无名的使用SOAP方法调用的参数值。


参数：xmlns
the namespace given either as a simple string or as a named character vector of namespace URIs and local names. (Currently only one namespace is used). This is used for the top-level element of the node within the SOAP Body, corresponding to the actual request.
无论是作为一个简单的字符串或一个命名空间URI和本地名称命名的特征向量给出的命名空间。 （目前只有一个命名空间）。这是用于顶级节点内的SOAP Body元素，对应的实际要求。


参数：con
the connection object on which to write the HTTP and SOAP content
连接对象上写的HTTP和SOAP内容


参数：.types
a list parallelling the arguments to the SOAP method (i.e. ... or .soapArgs) that specify the expected/required type of the individual arguments.  This information is typically constructed from the WSDL (Web Services Description Language) if that is available.  Otherwise, this can be an empty list in which case no constraints are placed on the arguments and the values are used as-is.   
SOAP方法（即...或.soapArgs）/需要的各个参数的预期类型指定parallelling参数列表。此信息通常建造从WSDL（Web服务描述语言），如果是可用的。否则，这可能是没有任何限制，在这种情况下，被放置在参数值用来作为 - 是一个空列表。


参数：nameSpaces
a named character vector giving the namespace identifier and URI pairs. These are added as attributes in the SOAP Body element of the generated XML.
命名空间标识符和URI对已命名的字符向量。这些都增加了在SOAPBody生成的XML元素的属性。


参数：.literal
a logical value indicating whether to use the literal format of the encoding for the seralization of objects.
一个逻辑值，该值指示是否使用文字编码格式对象seralization的。


参数：.header
a character string (or NULL that is written as part of the SOAP header (not the HTTP header), before any other output, i.e. before the <SOAP-ENV:Body> is emitted. This is passed as the first argument to writeSOAPHeader.  
一个字符串（或NULL被写入SOAP标头（HTTP头），其他任何输出之前，即前<SOAP-ENV:Body>发出，这是作为第一个参数传递writeSOAPHeader。


参数：.soapHeader
a string, an XML node or a function that can be optionally specified to add content to the SOAP message as the header of the envelope.  This is used in some Web services to provide transaction information such as a authentication and security details. See the eBaySvc.wsdl for an example. If this is a function, it is called with the value of con as the only argument. One might use a closure to include the  &quot;private&quot; and auxiliary information.  
一个字符串，一个XML节点或一个可以随意指定将内容添加到SOAP消息的信封头的功能。这是用在一些Web服务，提供交易，如身份验证和安全性的详细信息。看到为例eBaySvc.wsdl。如果这是一个函数，它被称为con作为唯一的参数值。有人可能会使用一个闭包，包括“私人”和辅助信息。


参数：.elementFormQualified
a logical value. If this is FALSE, only the XML element identifying the method  call in the Body of the SOAP request uses the target namespace. The XML nodes representing the arguments in the method call do not use this namespace but are global. Alternatively, if this is TRUE, the target namespace of the schema is defined as the default name space on the XML element for the method call and so is inherited by the elements for the parameters.   
一个逻辑值。如果这是FALSE，只有确定在身体的SOAP请求的方法调用的XML元素的目标命名空间使用。代表在方法调用的参数的XML节点不使用此命名空间，而且是全球性的。另外，如果TRUE，该架构的目标命名空间定义上的方法调用的XML元素的默认名称空间等参数的元素继承。


值----------Value----------

For each function, the return value is irrelevant. It is the side-effect of writing to the connection that is used for.
对于每个函数，返回值是无关紧要的。它是用于连接书面副作用。


注意----------Note----------

A different approach is to create the XML &ldquo;payload&rdquo; first as a string (by creating it as an XML tree and then serializing that to a buffer). This allows one to add the Content-Length to the HTTP header.
另一种方法是先创建一个字符串（创建一个XML树，然后序列，缓冲区）的XML“有效载荷”。这允许你添加的内容长度的HTTP头。


作者（S）----------Author(s)----------


Duncan Temple Lang &lt;duncan@wald.ucdavis.edu&gt;



参考文献----------References----------

http://www.omegahat.org/SSOAP, http://www.omegahat.org/bugs.

参见----------See Also----------

.SOAP
.SOAP

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。