-
Notifications
You must be signed in to change notification settings - Fork 3
/
listing1.html
executable file
·421 lines (341 loc) · 14.6 KB
/
listing1.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html>
<head>
<!-- BEGIN META TAG INFO -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="home" href="http://developer.apple.com/">
<link rel="find" href="http://developer.apple.com/search/">
<link rel="stylesheet" type="text/css" href="../../documentation/css/adcstyle.css" title="fonts">
<script language="JavaScript" src="../../documentation/js/adc.js" type="text/javascript"></script>
<!-- END META TAG INFO -->
<!-- BEGIN TITLE -->
<title>OTSimpleDownloadHTTP - /OTSimpleDownloadHTTP.c</title>
<!-- END TITLE -->
<script language="JavaScript">
function JumpToNewPage() {
window.location=document.scpopupmenu.gotop.value;
return true;
}
</script>
</head>
<!-- BEGIN BODY OPEN -->
<body>
<!--END BODY OPEN -->
<!-- START CENTER OPEN -->
<center>
<!-- END CENTER OPEN -->
<!-- BEGIN LOGO AND SEARCH -->
<!--#include virtual="/includes/adcnavbar"-->
<!-- END LOGO AND SEARCH -->
<!-- START BREADCRUMB -->
<div id="breadcrumb">
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td scope="row"><img width="340" height="10" src="images/1dot.gif" alt=""></td>
<td><img width="340" height="10" src="images/1dot.gif" alt=""></td>
</tr>
<tr valign="middle">
<td align="left" colspan="2">
<a href="http://developer.apple.com/">ADC Home</a> > <a href="../../referencelibrary/index.html">Reference Library</a> > <a href="../../samplecode/index.html">Sample Code</a> > <a href="../../samplecode/LegacyTechnologies/index.html">Legacy Documents</a> > <a href="../../samplecode/LegacyTechnologies/idxCarbon-date.html">Carbon</a> > <A HREF="javascript:location.replace('index.html');">OTSimpleDownloadHTTP</A> >
</td>
</tr>
<tr>
<td colspan="2" scope="row"><img width="680" height="35" src="images/1dot.gif" alt=""></td>
</tr>
</table>
</div>
<!-- END BREADCRUMB -->
<div style="width:100%; position:fixed;"><div align="center" id="watermark" style="position: relative; margin-left:auto; margin-right:auto; z-index:20; width:500px;"><div class="legacybox"><h1>Legacy Document<span class=closebutton><a href="javascript:closeWatermark()"><img src="../../images/closebutton.png" width="14" height="14" border="0" alt="close button"></a></span></h1>
<p><strong>Important: </strong>This document is part of the Legacy section of the ADC Reference Library. This information should not be used for new development.</p>
<div class="reflibtopic">
<p>Current information on this Reference Library topic can be found here:</p>
<ul>
<li><a href="http://developer.apple.com/referencelibrary/Carbon/idxNetworking-date.html" target="_blank">Carbon > Networking</a></li>
</ul>
</div>
</div></div></div>
<!-- START MAIN CONTENT -->
<!-- START TITLE GRAPHIC AND INTRO-->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td><h1><div id="pagehead">OTSimpleDownloadHTTP</div></h1></td>
</tr>
</table>
<!-- END TITLE GRAPHIC AND INTRO -->
<!-- START WIDE COLUMN -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td id="scdetails">
<h2>/OTSimpleDownloadHTTP.c</h2>
<form name="scpopupmenu" onSubmit="return false;" method=post>
<p><strong>View Source Code:</strong>
<select name="gotop" onChange="JumpToNewPage();" style="width:340px"><option selected value="ingnore">Select File</option>
<option value="listing1.html">/OTSimpleDownloadHTTP.c</option>
<option value="listing2.html">/OTSimpleDownloadHTTP.h</option>
<option value="listing3.html">/OTSimpleDownloadHTTPTest.c</option></select>
</p>
</form>
<p><strong><a href="OTSimpleDownloadHTTP.zip">Download Sample</a></strong> (“OTSimpleDownloadHTTP.zip”, 54.4K)<BR>
<strong><a href="OTSimpleDownloadHTTP.dmg">Download Sample</a></strong> (“OTSimpleDownloadHTTP.dmg”, 119.4K)</p>
<!--
<p><strong><a href="#">Download Sample</a></strong> (“filename.sit”, 500K)</p>
-->
</td>
</tr>
<tr>
<td scope="row"><img width="680" height="10" src="images/1dot.gif" alt=""><br>
<img height="1" width="680" src="images/1dot_919699.gif" alt=""><br>
<img width="680" height="20" src="images/1dot.gif" alt=""></td>
</tr>
<tr>
<td scope="row">
<!--googleon: index -->
<pre class="sourcecodebox">/* File: OTSimpleDownloadHTTP.c Contains: Implementation of the simple HTTP download sample. Written by: Quinn "The Eskimo!" Copyright: Copyright © 1997-1999 by Apple Computer, Inc., All Rights Reserved. You may incorporate this Apple sample source code into your program(s) without restriction. This Apple sample source code has been provided "AS IS" and the responsibility for its operation is yours. You are not permitted to redistribute this Apple sample source code as "Apple sample source code" after having made changes. If you're going to re-distribute the source, we require that you make it clear in the source that the code was descended from Apple sample source code, but that you've made changes. Change History (most recent first): 3/02/2001 Chad Jones Updated to Metroworks Codewarrior Pro IDE 4.1. Also carbonized for OSX. 7/23/1999 Karl Groethe Updated for Metrowerks Codewarror Pro 2.1 *//////////////////////////////////////////////////////////////////////// Pick up our own prototype.#include "OTSimpleDownloadHTTP.h"/////////////////////////////////////////////////////////////////////// OTDebugStr is not defined in any OT header files, but it is// exported by the libraries, so we define the prototype here.extern pascal void OTDebugStr(const char* str);/////////////////////////////////////////////////////////////////////enum { kTransferBufferSize = 4096};/////////////////////////////////////////////////////////////////////static pascal void YieldingNotifier(void* contextPtr, OTEventCode code, OTResult result, void* cookie) // This simple notifier checks for kOTSyncIdleEvent and // when it gets one calls the Thread Manager routine // YieldToAnyThread. Open Transport sends kOTSyncIdleEvent // whenever it's waiting for something, eg data to arrive // inside a sync/blocking OTRcv call. In such cases, we // yield the processor to some other thread that might // be doing useful work.{ #pragma unused(contextPtr) #pragma unused(result) #pragma unused(cookie) OSStatus junk; switch (code) { case kOTSyncIdleEvent: junk = YieldToAnyThread(); MoreAssert(junk == noErr); //Assertion fails if: YieldToAnyThread failed break; default: // do nothing break; }}/////////////////////////////////////////////////////////////////////OSStatus DownloadHTTPSimple(const char *hostName, const char *httpCommand, const short destFileRefNum) // Download a URL from the a web server. hostName is a pointer // to a string that contains the DNS address of the web server. // The DNS address must be suffixed by ":<port>", where <port> // is the port number the web server is operating on. // httpCommand contains the HTTP command to send. Typically this // is of the form: // // GET <x> HTTP/1.0\0x0d\0x0a\0x0d\0x0a // // where <x> is the URL path. destFileRefNum is the file // reference number to which the results of the HTTP command // are written. This routine does not parse the returned HTTP // header in any way. The entire incoming stream goes into // the file verbatim. // // For example, if you were asked to download a URL like: // // http://devworld.apple.com/dev/technotes.shtml // // you would set: // // o hostName to "devworld.apple.com:80" (80 is the // default port for HTTP. // o httpCommand to "GET /dev/technotes.shtml HTTP/1.0\0x0d\0x0a\0x0d\0x0a"{ OSStatus err; OSStatus junk; Ptr transferBuffer = nil; EndpointRef ep = kOTInvalidEndpointRef; TCall sndCall; DNSAddress hostDNSAddress; OTFlags junkFlags; OTResult bytesSent; OTResult bytesReceived; OTResult lookResult; Boolean bound = false; // First allocate a buffer for storing the data as we read it. err = noErr; transferBuffer = OTAllocMemInContext(kTransferBufferSize,nil); if ( transferBuffer == nil ) { err = kENOMEMErr; } // Now open a TCP endpoint. if (err == noErr) { ep = OTOpenEndpointInContext(OTCreateConfiguration(kTCPName), 0, nil, &err,nil); } // If the endpoint opens successfully... if (err == noErr) { // Establish the modes of operation. This sample uses // sync/blocking mode, with sync idle events that yield // time using the Thread Manager. junk = OTSetSynchronous(ep); MoreAssert(junk == noErr); //Assertion Fails if: OTSetSynchronous failed junk = OTSetBlocking(ep); MoreAssert(junk == noErr); //Assertion Fails if: OTSetBlocking failed junk = OTInstallNotifier(ep, NewOTNotifyUPP(YieldingNotifier), nil); MoreAssert(junk == noErr); //Assertion Fails if: OTInstallNotifier failed junk = OTUseSyncIdleEvents(ep, true); MoreAssert(junk == noErr); //Assertion Fails if: OTUseSyncIdleEvents failed // Bind the endpoint. Because we're an outgoing connection, // we don't have to bind it to a specific address. err = OTBind(ep, nil, nil); bound = (err == noErr); } // Initialise the sndCall structure and call OTConnect. We nil // out most of the fields in the sndCall structure because // we don't want any special options or connection data. // The important field of the sndCall is the addr TNetBuf, // which we initialise to the if (err == noErr) { sndCall.addr.buf = (UInt8 *) &hostDNSAddress; sndCall.addr.len = OTInitDNSAddress(&hostDNSAddress, (char *) hostName); sndCall.opt.buf = nil; // no connection options sndCall.opt.len = 0; sndCall.udata.buf = nil; // no connection data sndCall.udata.len = 0; sndCall.sequence = 0; // ignored by OTConnect err = OTConnect(ep, &sndCall, nil); } // Send the HTTP command to the server. if (err == noErr) { bytesSent = OTSnd(ep, (void *) httpCommand, OTStrLength(httpCommand), 0); // OTSnd returns the number of bytes sent. Because we're in // synchronous mode, it won't return until it's sent all the // bytes, or it gets an error. if (bytesSent > 0) { err = noErr; } else { err = bytesSent; } } // Now that we have sent the HTTP command, we turn around and // receive the data comming back from the server. if (err == noErr) { do { bytesReceived = OTRcv(ep, (void *) transferBuffer, kTransferBufferSize, &junkFlags); // OTRcv returns the number of bytes received. Because we're in // synchronous mode, it won't return until it's sent all the // bytes, or it gets an error. if (bytesReceived > 0) { err = FSWrite(destFileRefNum, &bytesReceived, transferBuffer); } else { err = bytesReceived; } // We keep running this loop until we get an error. } while (err == noErr); } // Now we handle the various forms of error we can get. The // most common in kOTLookErr. This means that some event // has happened that we need to look at. We call OTLook // to get the event code and then handle the various types // of event appropriately. if (err == kOTLookErr) { lookResult = OTLook(ep); switch (lookResult) { case T_DISCONNECT: // If we get a T_DISCONNECT event, the remote peer // has disconnected the stream in a dis-orderly // fashion. HTTP servers will often just disconnect // a connection like this to indicate the end of the // data, so all we need do is clear the T_DISCONNECT // event on the endpoint. err = OTRcvDisconnect(ep, nil); break; case T_ORDREL: // If we get a T_ORDREL event, the remote peer // has disconnected the stream in an orderly // fashion. This orderly disconnect indicates that // the end of the data. We respond by clearing // the T_ORDREL, and then calling OTSndOrderlyDisconnect // to acknowledge the orderly disconnect at // the remote peer. err = OTRcvOrderlyDisconnect(ep); if (err == noErr) { err = OTSndOrderlyDisconnect(ep); } break; default: // Leave err as kOTLookErr. break; } } if ( (err == noErr) && bound ) { junk = OTUnbind(ep); MoreAssert(junk == noErr); //Assertion Fails if: OTUnbind failed } // Clean up. if (ep != kOTInvalidEndpointRef) { junk = OTCloseProvider(ep); MoreAssert(junk == noErr); //Assertion Fails if: OTCloseProvider failed } if (transferBuffer != nil) { OTFreeMem(transferBuffer); } return (err);}</pre>
<!--googleoff: index -->
</td>
</tr>
</table>
<!-- END WIDE COLUMN -->
<!-- END MAIN CONTENT -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td><div style="width: 100%; height: 1px; background-color: #919699; margin-top: 5px; margin-bottom: 15px"></div></td>
</tr>
<tr>
<td align="center"><br/>
<table border="0" cellpadding="0" cellspacing="0" class="graybox">
<tr>
<th>Did this document help you?</th>
</tr>
<tr>
<td>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=1&url=/samplecode/OTSimpleDownloadHTTP/listing1.html%3Fid%3DDTS10000710-1.0&media=dvd" target=_new>Yes</a>: Tell us what works for you.</div>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=2&url=/samplecode/OTSimpleDownloadHTTP/listing1.html%3Fid%3DDTS10000710-1.0&media=dvd" target=_new>It’s good, but:</a> Report typos, inaccuracies, and so forth.</div>
<div><a href="http://developer.apple.com/feedback/?v=3&url=/samplecode/OTSimpleDownloadHTTP/listing1.html%3Fid%3DDTS10000710-1.0&media=dvd" target=_new>It wasn’t helpful</a>: Tell us what would have helped.</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- START BOTTOM APPLE NAVIGATION -->
<!--#include virtual="/includes/footer"-->
<!-- END BOTTOM APPLE NAVIGATION -->
<!-- START CENTER CLOSE -->
</center>
<!-- END CENTER CLOSE -->
</body>
</html>