archived-doc-es/reference/sca/SCA/getService.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5c20ff9960166638320c32da9004e1b30ec6e9f0 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->

<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry xml:id="sca.getservice" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>SCA::getService</refname>
  <refpurpose>
   Obtener un delegado para un servicio
  </refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>mixed</type>
   <methodname>SCA::getService</methodname>
   <methodparam>
    <type>string</type>
    <parameter>target</parameter>
   </methodparam>
   <methodparam choice="opt">
    <type>string</type>
    <parameter>binding</parameter>
   </methodparam>   
   <methodparam choice="opt">
    <type>array</type>
    <parameter>config</parameter>
   </methodparam>   
  </methodsynopsis>
  
  &warn.experimental.func;
  
  <para>Examina el objetivo e inicializa y devuelve un delegado del tipo
   apropiado. Si el objetivo es para un componente de PHP local, el delegado devuelto será un
   SCA_LocalProxy. Si el objeitov es para un fichero WSDL, el delegado devuelto será un
   SCA_SoapProxy.</para>
  
 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term>
      <parameter>target</parameter>
     </term>
     <listitem>
      <para>Una ruta absoluta o relativa al servicio objetivo o descripción de
       servicio (p.ej. una URL a una descripción de un servicio json-rpc, un componente
       de PHP , un fichero WSDL, etc.). Una ruta relativa, si se especifica, 
       se resuelve relativa a la ubicación  del script que emite la llamada a
       <function>getService</function>, y no con include_path 
       o el directorio actual de trabajo.</para>
     </listitem>
   </varlistentry>
   <varlistentry>
    <term>
     <parameter>binding</parameter>
    </term>
    <listitem>
     <para>La vinculación (esto es, el protocolo) a usar para comunicarse con el servicio
      (p.ej. binding.jsonrpc para un servicio json-rpc). Observe que algunos tipos de servicios
      se pueden deducir del parámetro target (p.ej. si el parámetro target 
      finaliza con .wsdl, SCA asumirá binding.soap). Cualquier vinculación que
      pueda ser especificada en una anotación se puede especificar aquí. Por ejemplo,
      'binding.soap' es equivalente a la anotación '@binding.soap'.</para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term>
     <parameter>config</parameter>
    </term>
    <listitem>
     <para>Cualquier propiedad de configuración adiciones para la vinculación (p.ej.
      array('location' => 'http://example.org')). Cualquier configuración de vinculación
      que pueda ser especificada en una anotación se puede especificar aquí. Por
      ejemplo, 'location' es equivalente a la anotación '@location' para 
      configurar la ubicación de un servicio soap objetivo.</para>
    </listitem>
   </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   El SCA_LocalProxy o SCA_SoapProxy.
  </para>
 </refsect1>
 
 <!-- Use when ERRORS exist
 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   When does this function throw E_* level errors, or exceptions?
  </para>
 </refsect1>
 -->
 
 
 <!-- Use when a CHANGELOG exists
 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>Enter the PHP version of change here
       <entry>Description of change
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>
 -->
 
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Un ejemplo de <function>SCA::getService</function></title>
    <para>
     Este ejemplo muestra cómo obtener un delegado para un servicio soap de email descrito
     por <filename>EmailService.wsdl</filename> y ubicado en 
     <filename>http://example.org</filename>.
    </para>
    <programlisting role="php">
<![CDATA[
<?php
include 'SCA/SCA.php';
$service = SCA::getService('EmailService.wsdl', 'binding.soap', array('location' => 'http://example.org'));
$service->send(...);
?>
]]>
    </programlisting>
    &example.outputs;
   </example>
  </para>
 </refsect1>
 
 
 <!-- Use when adding See Also links
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function></function></member>
    <member>Or <link linkend="somethingelse">something else</link></member>
   </simplelist>
  </para>
 </refsect1>
 -->
 
 
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->