nxtOSEK/lejos_nxj/docs/apidocs/javax/microedition/io/StreamConnection.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <!--NewPage-->
   3 <HTML>
   4 <HEAD>
   5 <!-- Generated by javadoc (build 1.5.0_09) on Sun Sep 02 23:07:08 BST 2007 -->
   6 <TITLE>
   7 StreamConnection (leJOS NXT API documentation)
   8 </TITLE>
   9
  10 <META NAME="keywords" CONTENT="javax.microedition.io.StreamConnection interface">
  11
  12 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  13
  14 <SCRIPT type="text/javascript">
  15 function windowTitle()
  16 {
  17     parent.document.title="StreamConnection (leJOS NXT API documentation)";
  18 }
  19 </SCRIPT>
  20 <NOSCRIPT>
  21 </NOSCRIPT>
  22
  23 </HEAD>
  24
  25 <BODY BGCOLOR="white" onload="windowTitle();">
  26
  27
  28 <!-- ========= START OF TOP NAVBAR ======= -->
  29 <A NAME="navbar_top"><!-- --></A>
  30 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
  31 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
  32 <TR>
  33 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  34 <A NAME="navbar_top_firstrow"><!-- --></A>
  35 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  36   <TR ALIGN="center" VALIGN="top">
  37   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  38   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  39   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  40   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  41   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  42   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  43   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  44   </TR>
  45 </TABLE>
  46 </TD>
  47 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  48 </EM>
  49 </TD>
  50 </TR>
  51
  52 <TR>
  53 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  54 &nbsp;PREV CLASS&nbsp;
  55 &nbsp;NEXT CLASS</FONT></TD>
  56 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  57   <A HREF="../../../index.html?javax/microedition/io/StreamConnection.html" target="_top"><B>FRAMES</B></A>  &nbsp;
  58 &nbsp;<A HREF="StreamConnection.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
  59 &nbsp;<SCRIPT type="text/javascript">
  60   <!--
  61   if(window==top) {
  62     document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  63   }
  64   //-->
  65 </SCRIPT>
  66 <NOSCRIPT>
  67   <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
  68 </NOSCRIPT>
  69
  70
  71 </FONT></TD>
  72 </TR>
  73 <TR>
  74 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  75   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  76 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  77 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  78 </TR>
  79 </TABLE>
  80 <A NAME="skip-navbar_top"></A>
  81 <!-- ========= END OF TOP NAVBAR ========= -->
  82
  83 <HR>
  84 <!-- ======== START OF CLASS DATA ======== -->
  85 <H2>
  86 <FONT SIZE="-1">
  87 javax.microedition.io</FONT>
  88 <BR>
  89 Interface StreamConnection</H2>
  90 <DL>
  91 <DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../lejos/nxt/comm/BTConnection.html" title="class in lejos.nxt.comm">BTConnection</A>, <A HREF="../../../lejos/nxt/comm/USBConnection.html" title="class in lejos.nxt.comm">USBConnection</A></DD>
  92 </DL>
  93 <HR>
  94 <DL>
  95 <DT><PRE>public interface <B>StreamConnection</B></DL>
  96 </PRE>
  97
  98 <P>
  99 This interface defines the capabilities that a stream connection must have.
 100
 101  StreamConnections have one underlying InputStream and one OutputStream.
 102
 103  Opening a DataInputStream counts as opening an InputStream and opening a DataOutputStream counts as opening an OutputStream.
 104
 105  Trying to open another InputStream or OutputStream causes an IOException.
 106
 107  Trying to open the InputStream or OutputStream after they have been closed causes an IOException
 108 <P>
 109
 110 <P>
 111 <HR>
 112
 113 <P>
 114
 115 <!-- ========== METHOD SUMMARY =========== -->
 116
 117 <A NAME="method_summary"><!-- --></A>
 118 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 119 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 120 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
 121 <B>Method Summary</B></FONT></TH>
 122 </TR>
 123 <TR BGCOLOR="white" CLASS="TableRowColor">
 124 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 125 <CODE>&nbsp;void</CODE></FONT></TD>
 126 <TD><CODE><B><A HREF="../../../javax/microedition/io/StreamConnection.html#close()">close</A></B>()</CODE>
 127
 128 <BR>
 129 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Close the stream connection</TD>
 130 </TR>
 131 <TR BGCOLOR="white" CLASS="TableRowColor">
 132 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 133 <CODE>&nbsp;<A HREF="../../../java/io/DataInputStream.html" title="class in java.io">DataInputStream</A></CODE></FONT></TD>
 134 <TD><CODE><B><A HREF="../../../javax/microedition/io/StreamConnection.html#openDataInputStream()">openDataInputStream</A></B>()</CODE>
 135
 136 <BR>
 137 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Open and return a DataInputStream - not yet implemented.</TD>
 138 </TR>
 139 <TR BGCOLOR="white" CLASS="TableRowColor">
 140 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 141 <CODE>&nbsp;<A HREF="../../../java/io/DataOutputStream.html" title="class in java.io">DataOutputStream</A></CODE></FONT></TD>
 142 <TD><CODE><B><A HREF="../../../javax/microedition/io/StreamConnection.html#openDataOutputStream()">openDataOutputStream</A></B>()</CODE>
 143
 144 <BR>
 145 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Open and return a DataOutputStream - not yet implemented.</TD>
 146 </TR>
 147 <TR BGCOLOR="white" CLASS="TableRowColor">
 148 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 149 <CODE>&nbsp;<A HREF="../../../java/io/InputStream.html" title="class in java.io">InputStream</A></CODE></FONT></TD>
 150 <TD><CODE><B><A HREF="../../../javax/microedition/io/StreamConnection.html#openInputStream()">openInputStream</A></B>()</CODE>
 151
 152 <BR>
 153 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Open and return an InputStream - not yet implemented.</TD>
 154 </TR>
 155 <TR BGCOLOR="white" CLASS="TableRowColor">
 156 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 157 <CODE>&nbsp;<A HREF="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</A></CODE></FONT></TD>
 158 <TD><CODE><B><A HREF="../../../javax/microedition/io/StreamConnection.html#openOutputStream()">openOutputStream</A></B>()</CODE>
 159
 160 <BR>
 161 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Open and return an OutputStream - not yet implemented.</TD>
 162 </TR>
 163 </TABLE>
 164 &nbsp;
 165 <P>
 166
 167 <!-- ============ METHOD DETAIL ========== -->
 168
 169 <A NAME="method_detail"><!-- --></A>
 170 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 171 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 172 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
 173 <B>Method Detail</B></FONT></TH>
 174 </TR>
 175 </TABLE>
 176
 177 <A NAME="close()"><!-- --></A><H3>
 178 close</H3>
 179 <PRE>
 180 void <B>close</B>()
 181            throws <A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 182 <DL>
 183 <DD>Close the stream connection
 184 <P>
 185 <DD><DL>
 186
 187 <DT><B>Throws:</B>
 188 <DD><CODE><A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></CODE></DL>
 189 </DD>
 190 </DL>
 191 <HR>
 192
 193 <A NAME="openInputStream()"><!-- --></A><H3>
 194 openInputStream</H3>
 195 <PRE>
 196 <A HREF="../../../java/io/InputStream.html" title="class in java.io">InputStream</A> <B>openInputStream</B>()
 197                             throws <A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 198 <DL>
 199 <DD>Open and return an InputStream - not yet implemented.
 200 <P>
 201 <DD><DL>
 202
 203 <DT><B>Throws:</B>
 204 <DD><CODE><A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></CODE></DL>
 205 </DD>
 206 </DL>
 207 <HR>
 208
 209 <A NAME="openDataInputStream()"><!-- --></A><H3>
 210 openDataInputStream</H3>
 211 <PRE>
 212 <A HREF="../../../java/io/DataInputStream.html" title="class in java.io">DataInputStream</A> <B>openDataInputStream</B>()
 213                                     throws <A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 214 <DL>
 215 <DD>Open and return a DataInputStream - not yet implemented.
 216 <P>
 217 <DD><DL>
 218
 219 <DT><B>Throws:</B>
 220 <DD><CODE><A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></CODE></DL>
 221 </DD>
 222 </DL>
 223 <HR>
 224
 225 <A NAME="openOutputStream()"><!-- --></A><H3>
 226 openOutputStream</H3>
 227 <PRE>
 228 <A HREF="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</A> <B>openOutputStream</B>()
 229                               throws <A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 230 <DL>
 231 <DD>Open and return an OutputStream - not yet implemented.
 232 <P>
 233 <DD><DL>
 234
 235 <DT><B>Throws:</B>
 236 <DD><CODE><A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></CODE></DL>
 237 </DD>
 238 </DL>
 239 <HR>
 240
 241 <A NAME="openDataOutputStream()"><!-- --></A><H3>
 242 openDataOutputStream</H3>
 243 <PRE>
 244 <A HREF="../../../java/io/DataOutputStream.html" title="class in java.io">DataOutputStream</A> <B>openDataOutputStream</B>()
 245                                       throws <A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 246 <DL>
 247 <DD>Open and return a DataOutputStream - not yet implemented.
 248 <P>
 249 <DD><DL>
 250
 251 <DT><B>Throws:</B>
 252 <DD><CODE><A HREF="../../../java/io/IOException.html" title="class in java.io">IOException</A></CODE></DL>
 253 </DD>
 254 </DL>
 255 <!-- ========= END OF CLASS DATA ========= -->
 256 <HR>
 257
 258
 259 <!-- ======= START OF BOTTOM NAVBAR ====== -->
 260 <A NAME="navbar_bottom"><!-- --></A>
 261 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
 262 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
 263 <TR>
 264 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
 265 <A NAME="navbar_bottom_firstrow"><!-- --></A>
 266 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
 267   <TR ALIGN="center" VALIGN="top">
 268   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
 269   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
 270   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
 271   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
 272   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
 273   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
 274   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
 275   </TR>
 276 </TABLE>
 277 </TD>
 278 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
 279 </EM>
 280 </TD>
 281 </TR>
 282
 283 <TR>
 284 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 285 &nbsp;PREV CLASS&nbsp;
 286 &nbsp;NEXT CLASS</FONT></TD>
 287 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 288   <A HREF="../../../index.html?javax/microedition/io/StreamConnection.html" target="_top"><B>FRAMES</B></A>  &nbsp;
 289 &nbsp;<A HREF="StreamConnection.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
 290 &nbsp;<SCRIPT type="text/javascript">
 291   <!--
 292   if(window==top) {
 293     document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
 294   }
 295   //-->
 296 </SCRIPT>
 297 <NOSCRIPT>
 298   <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
 299 </NOSCRIPT>
 300
 301
 302 </FONT></TD>
 303 </TR>
 304 <TR>
 305 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 306   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
 307 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 308 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
 309 </TR>
 310 </TABLE>
 311 <A NAME="skip-navbar_bottom"></A>
 312 <!-- ======== END OF BOTTOM NAVBAR ======= -->
 313
 314 <HR>
 315
 316 </BODY>
 317 </HTML>