<?xml version="1.0" encoding="iso-8859-2"?>
<!--

	$Id: satellite.xml,v 1.8 2002/02/02 15:32:53 hholzgra Exp $

	Author: David Eriksson <david@2good.com>

-->

 <reference id="ref.satellite">
  <title>Satellite CORBA klient extenze</title>
  <titleabbrev>Satellite</titleabbrev>

  <partintro>
   &warn.experimental;
   <para>
    Satellite extenze se pouv pro pstup ke CORBA objektm. Vyaduje
    idl_directory= poloku v php.ini ukazujc na cestu kde jsou vechny
    pouvan IDL soubory.
   </para>
  </partintro>

  <refentry id="class.orbitobject">
   <refnamediv>
    <refname>OrbitObject</refname>
    <refpurpose>Zpstupnit CORBA objekty</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>new</type><methodname>OrbitObject</methodname>
      <methodparam><type>string</type><parameter>ior</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato tda poskytuje pstup ke CORBA objektu. Argument
     <parameter>ior</parameter> by ml bt etzec obsahujc IOR
     (Interoperable Object Reference) kter identifikuje vzdlen objekt.
    </para>
    <para>
     <example>
      <title>Ukzkov IDL soubor</title>
      <programlisting>
interface MyInterface {
    void SetInfo (string info);
    string GetInfo();

    attribute int value;
}
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>PHP kd pro pstup k MyInterface</title>
      <programlisting role="php">
&lt;?php
$obj = new OrbitObject ($ior);

$obj->SetInfo ("A 2GooD object");

echo $obj->GetInfo();

$obj->value = 42;

echo $obj->value;
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="class.orbitenum">
   <refnamediv>
    <refname>OrbitEnum</refname>
    <refpurpose>Pout CORBA enumerace</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>new</type><methodname>OrbitEnum</methodname>
      <methodparam><type>string</type><parameter>id</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato tda pedstavuje enumeraci urenou argumentem
     <parameter>id</parameter> parameter. <parameter>id</parameter> me bt bu
     nzev tto enumerace (nap. "MyEnum"), nebo pln repository id (nap.
     "IDL:MyEnum:1.0").
    </para>
    <para>
     <example>
      <title>Ukzkov IDL soubor</title>
      <programlisting>
enum MyEnum {
    a,b,c,d,e
};
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>PHP kd pro pstup k MyEnum</title>
      <programlisting role="php">
&lt;?php
$enum = new OrbitEnum ("MyEnum");

echo $enum->a;	/* write 0 */
echo $enum->c;	/* write 2 */
echo $enum->e;	/* write 4 */
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="class.orbitstruct">
   <refnamediv>
    <refname>OrbitStruct</refname>
    <refpurpose>Pout CORBA struktury</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>new</type><methodname>OrbitStruct</methodname>
      <methodparam><type>string</type><parameter>id</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato tda pedstavuje strukturu urenou argumentem
     <parameter>id</parameter>. <parameter>id</parameter> me bt bu nzev
     tto struktury (nap. "MyStruct"), nebo pln repository id
     (nap. "IDL:MyStruct:1.0").
    </para>
    <para>
     <example>
      <title>Ukzkov IDL soubor</title>
      <programlisting>
struct MyStruct {
    short shortvalue;
    string stringvalue;
};

interface SomeInterface {
  void SetValues (MyStruct values);
  MyStruct GetValues();
}
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>PHP kd pro pstup k MyStruct</title>
      <programlisting role="php">
&lt;?php
$obj = new OrbitObject ($ior);

$initial_values = new OrbitStruct ("IDL:MyStruct:1.0");
$initial_values->shortvalue = 42;
$initial_values->stringvalue = "HGTTG";

$obj->SetValues ($initial_values);

$values = $obj->GetValues();

echo $values->shortvalue;
echo $values->stringvalue;
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.satellite_caught_exception">
   <refnamediv>
    <refname>satellite_caught_exception</refname>
    <refpurpose>
     Zjistit, jestli byla v pedchoz funkci zachycena vjimka
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>satellite_caught_exception</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Tato funkce vrac &true;, pokud byla zachycena vjimka.
    </para>
    <para>
     <example>
      <title>Ukzkov IDL soubor</title>
      <programlisting>
/* ++?????++ Out of Cheese Error. Redo From Start. */
exception OutOfCheeseError {
    int parameter;
}

interface AnotherInterface {
    void AskWhy() raises (OutOfCheeseError);
}
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>PHP kd pro zpracovn CORBA vjimek</title>
      <programlisting role="php">
&lt;?php
$obj = new OrbitObject ($ior);

$obj->AskWhy();

if (satellite_caught_exception()) {
    if ("IDL:OutOfCheeseError:1.0" == satellite_exception_id()) {
        $exception = satellite_exception_value();
        echo $exception->parameter;
    }
}
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.satellite_exception_id">
   <refnamediv>
    <refname>satellite_exception_id</refname>
    <refpurpose>Zjistit repository id posledn vjimky</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>satellite_exception_id</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Vrac etzec obsahujc repository id (napr. "IDL:MyException:1.0".).
     Ukzkov pouit viz <function>satellite_caught_exception</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.satellite_exception_value">
   <refnamediv>
    <refname>satellite_exception_value</refname>
    <refpurpose>Zskat strukturu posledn vjimky</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>OrbitStruct</type><methodname>satellite_exception_value</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Vrt strukturu vjimky. Ukzkov pouit viz
     <function>satellite_caught_exception</function>.
    </para>
   </refsect1>
  </refentry>
 </reference>

<!-- 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:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->