home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _7b4a37d8cfd0d8ac2ee9bf57eac0605c < prev    next >
Text File  |  2000-03-23  |  4KB  |  118 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Class::Tom - The Transportable Object Model for Perl</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Class::Tom - The Transportable Object Model for Perl</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#methods">METHODS</A></LI>
  26.     <LI><A HREF="#bugs">BUGS</A></LI>
  27.     <LI><A HREF="#author">AUTHOR</A></LI>
  28.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  29. </UL>
  30. <!-- INDEX END -->
  31.  
  32. <HR>
  33. <P>
  34. <H1><A NAME="name">NAME</A></H1>
  35. <P>Class::Tom - The Transportable Object Model for Perl</P>
  36. <P>
  37. <HR>
  38. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  39. <UL>
  40. <LI>Linux</LI>
  41. <LI>Solaris</LI>
  42. <LI>Windows</LI>
  43. </UL>
  44. <HR>
  45. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  46. <P>use Class::Tom qw ( restore );</P>
  47. <P>my $tom = new Class::Tom;</P>
  48. <P>$tom->insert(<OBJECT>);</P>
  49. <P>$tom->insert(<ANONYMOUS SUB>);</P>
  50. <P>$tom->insert(<PACKAGE NAME>);</P>
  51. <P>my $flat = $tom->store();</P>
  52. <P>my $newtom = restore( $flat );</P>
  53. <P>
  54. <HR>
  55. <H1><A NAME="description">DESCRIPTION</A></H1>
  56. <P><CODE>Class::Tom</CODE> allows you to transport objects from one system to another
  57. without requiring that the packages the object relies on actually exist on
  58. the other machine.</P>
  59. <P>
  60. <HR>
  61. <H1><A NAME="methods">METHODS</A></H1>
  62. <DL>
  63. <DT><STRONG><A NAME="item_new">new</A></STRONG><BR>
  64. <DD>
  65. <A HREF="#item_new"><CODE>new</CODE></A> is the objects constructor.  It can optionally take the Encoder
  66. argument if you've created a new encoding scheme.
  67. <P></P>
  68. <DT><STRONG><A NAME="item_insert">insert</A></STRONG><BR>
  69. <DD>
  70. The <A HREF="#item_insert"><CODE>insert</CODE></A> method accepts one of three things as an argument, a) an
  71. CODE reference (such as an anonymous subroutine or a reference to a
  72. subroutine), b) an Object or c) a string that contains the package name.
  73. If you insert an Object then <A HREF="#item_insert"><CODE>insert</CODE></A> returns the id of that object in
  74. the internal object list.
  75. <P></P>
  76. <DT><STRONG><A NAME="item_extract">extract</A></STRONG><BR>
  77. <DD>
  78. The <A HREF="#item_extract"><CODE>extract</CODE></A> method returns an object that has been <A HREF="#item_insert"><CODE>insert</CODE></A>'ed.  The
  79. argument is the Id of the object you insert.
  80. <P></P>
  81. <DT><STRONG><A NAME="item_store">store</A></STRONG><BR>
  82. <DD>
  83. The <A HREF="#item_store"><CODE>store</CODE></A> method returns the flattened container ready for shipping.
  84. <P></P>
  85. <DT><STRONG><A NAME="item_register">register</A></STRONG><BR>
  86. <DD>
  87. The <A HREF="#item_register"><CODE>register</CODE></A> method evals each of the methods stored inside the TOM
  88. compartment
  89. <P></P>
  90. <DT><STRONG><A NAME="item_restore">restore</A></STRONG><BR>
  91. <DD>
  92. <A HREF="#item_restore"><CODE>restore</CODE></A> is optionally exported, and is used to turn a flattened TOM
  93. object into a real perl object.
  94. <P></P></DL>
  95. <P>
  96. <HR>
  97. <H1><A NAME="bugs">BUGS</A></H1>
  98. <P>There are probably loads.  I've not had time to test this on any machine
  99. other than my own,  so your milage may vary.  Remember, this is a beta
  100. version.  3.02 will be the full bugfixed release.</P>
  101. <P>
  102. <HR>
  103. <H1><A NAME="author">AUTHOR</A></H1>
  104. <P>James A. Duncan <<A HREF="mailto:j@mesduncan.co.uk">j@mesduncan.co.uk</A>></P>
  105. <P>
  106. <HR>
  107. <H1><A NAME="see also">SEE ALSO</A></H1>
  108. <P><CODE>perl(1)</CODE></P>
  109. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  110. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  111. <STRONG><P CLASS=block> Class::Tom - The Transportable Object Model for Perl</P></STRONG>
  112. </TD></TR>
  113. </TABLE>
  114.  
  115. </BODY>
  116.  
  117. </HTML>
  118.