BLIP/BLIPConnection.m
author Jens Alfke <jens@mooseyard.com>
Sun Jul 13 10:42:50 2008 -0700 (2008-07-13)
changeset 22 8b883753394a
parent 18 3be241de1630
child 49 20cccc7c26ee
permissions -rw-r--r--
* Fixed: Responses still pending when a connection closed were not calling their onComplete targets.
* Fixed: BLIPTestClient target failed to build because it didn't link against zlib.
* If TCPListener.bonjourServiceName is changed while the listener is open, it now re-publishes the service with the new name.
* Added a TCPListener.bonjourService property.
* Added a BLIPMessage.representedObject property.
* Fixed a memory leak.
jens@0
     1
//
jens@0
     2
//  BLIPConnection.m
jens@0
     3
//  MYNetwork
jens@0
     4
//
jens@0
     5
//  Created by Jens Alfke on 5/10/08.
jens@0
     6
//  Copyright 2008 Jens Alfke. All rights reserved.
jens@0
     7
//
jens@0
     8
jens@0
     9
#import "BLIPConnection.h"
jens@0
    10
#import "BLIP_Internal.h"
jens@19
    11
#import "TCP_Internal.h"
jens@0
    12
#import "BLIPReader.h"
jens@0
    13
#import "BLIPWriter.h"
jens@0
    14
#import "BLIPDispatcher.h"
jens@0
    15
jens@0
    16
#import "Logging.h"
jens@0
    17
#import "Test.h"
jens@0
    18
#import "ExceptionUtils.h"
jens@18
    19
#import "Target.h"
jens@0
    20
jens@0
    21
jens@0
    22
NSString* const BLIPErrorDomain = @"BLIP";
jens@0
    23
jens@0
    24
NSError *BLIPMakeError( int errorCode, NSString *message, ... )
jens@0
    25
{
jens@0
    26
    va_list args;
jens@0
    27
    va_start(args,message);
jens@0
    28
    message = [[NSString alloc] initWithFormat: message arguments: args];
jens@0
    29
    va_end(args);
jens@0
    30
    LogTo(BLIP,@"BLIPError #%i: %@",errorCode,message);
jens@0
    31
    NSDictionary *userInfo = [NSDictionary dictionaryWithObject: message
jens@0
    32
                                                         forKey: NSLocalizedDescriptionKey];
jens@0
    33
    [message release];
jens@0
    34
    return [NSError errorWithDomain: BLIPErrorDomain code: errorCode userInfo: userInfo];
jens@0
    35
}
jens@0
    36
jens@0
    37
jens@18
    38
@interface BLIPConnection ()
jens@18
    39
- (void) _handleCloseRequest: (BLIPRequest*)request;
jens@18
    40
@end
jens@0
    41
jens@0
    42
jens@0
    43
@implementation BLIPConnection
jens@0
    44
jens@18
    45
jens@0
    46
- (void) dealloc
jens@0
    47
{
jens@0
    48
    [_dispatcher release];
jens@0
    49
    [super dealloc];
jens@0
    50
}
jens@0
    51
jens@0
    52
- (Class) readerClass                                       {return [BLIPReader class];}
jens@0
    53
- (Class) writerClass                                       {return [BLIPWriter class];}
jens@0
    54
- (id<BLIPConnectionDelegate>) delegate                     {return (id)_delegate;}
jens@0
    55
- (void) setDelegate: (id<BLIPConnectionDelegate>)delegate  {_delegate = delegate;}
jens@0
    56
jens@18
    57
jens@18
    58
#pragma mark -
jens@18
    59
#pragma mark RECEIVING:
jens@18
    60
jens@18
    61
jens@0
    62
- (BLIPDispatcher*) dispatcher
jens@0
    63
{
jens@0
    64
    if( ! _dispatcher ) {
jens@0
    65
        _dispatcher = [[BLIPDispatcher alloc] init];
jens@0
    66
        _dispatcher.parent = ((BLIPListener*)self.server).dispatcher;
jens@0
    67
    }
jens@0
    68
    return _dispatcher;
jens@0
    69
}
jens@0
    70
jens@0
    71
jens@18
    72
- (void) _dispatchMetaRequest: (BLIPRequest*)request
jens@18
    73
{
jens@18
    74
    NSString* profile = request.profile;
jens@18
    75
    if( [profile isEqualToString: kBLIPProfile_Bye] )
jens@18
    76
        [self _handleCloseRequest: request];
jens@18
    77
    else
jens@18
    78
        [request respondWithErrorCode: kBLIPError_NotFound message: @"Unknown meta profile"];
jens@18
    79
}
jens@18
    80
jens@18
    81
jens@0
    82
- (void) _dispatchRequest: (BLIPRequest*)request
jens@0
    83
{
jens@0
    84
    LogTo(BLIP,@"Received all of %@",request.descriptionWithProperties);
jens@0
    85
    @try{
jens@18
    86
        if( request._flags & kBLIP_Meta )
jens@18
    87
            [self _dispatchMetaRequest: request];
jens@18
    88
        else if( ! [self.dispatcher dispatchMessage: request] )
jens@0
    89
            [self tellDelegate: @selector(connection:receivedRequest:) withObject: request];
jens@0
    90
        if( ! request.noReply && ! request.repliedTo ) {
jens@0
    91
            LogTo(BLIP,@"Returning default empty response to %@",request);
jens@2
    92
            [request respondWithData: nil contentType: nil];
jens@0
    93
        }
jens@0
    94
    }@catch( NSException *x ) {
jens@0
    95
        MYReportException(x,@"Dispatching BLIP request");
jens@0
    96
        [request respondWithException: x];
jens@0
    97
    }
jens@0
    98
}
jens@0
    99
jens@0
   100
- (void) _dispatchResponse: (BLIPResponse*)response
jens@0
   101
{
jens@0
   102
    LogTo(BLIP,@"Received all of %@",response);
jens@0
   103
    [self tellDelegate: @selector(connection:receivedResponse:) withObject: response];
jens@0
   104
}
jens@0
   105
jens@0
   106
jens@18
   107
#pragma mark -
jens@18
   108
#pragma mark SENDING:
jens@18
   109
jens@18
   110
jens@5
   111
- (BLIPRequest*) request
jens@0
   112
{
jens@5
   113
    return [[[BLIPRequest alloc] _initWithConnection: self body: nil properties: nil] autorelease];
jens@0
   114
}
jens@0
   115
jens@0
   116
- (BLIPRequest*) requestWithBody: (NSData*)body
jens@0
   117
                      properties: (NSDictionary*)properties
jens@0
   118
{
jens@0
   119
    return [[[BLIPRequest alloc] _initWithConnection: self body: body properties: properties] autorelease];
jens@0
   120
}
jens@0
   121
jens@0
   122
- (BLIPResponse*) sendRequest: (BLIPRequest*)request
jens@0
   123
{
jens@0
   124
    BLIPConnection *itsConnection = request.connection;
jens@0
   125
    if( itsConnection==nil )
jens@0
   126
        request.connection = self;
jens@0
   127
    else
jens@0
   128
        Assert(itsConnection==self,@"%@ is already assigned to a different BLIPConnection",request);
jens@0
   129
    return [request send];
jens@0
   130
}
jens@0
   131
jens@0
   132
jens@18
   133
#pragma mark -
jens@18
   134
#pragma mark CLOSING:
jens@18
   135
jens@18
   136
jens@18
   137
- (void) _beginClose
jens@18
   138
{
jens@18
   139
    // Override of TCPConnection method. Instead of closing the socket, send a 'bye' request:
jens@18
   140
    if( ! _blipClosing ) {
jens@18
   141
        LogTo(BLIPVerbose,@"Sending close request...");
jens@18
   142
        BLIPRequest *r = [self request];
jens@18
   143
        [r _setFlag: kBLIP_Meta value: YES];
jens@18
   144
        r.profile = kBLIPProfile_Bye;
jens@18
   145
        BLIPResponse *response = [r send];
jens@18
   146
        response.onComplete = $target(self,_receivedCloseResponse:);
jens@18
   147
    }
jens@18
   148
    // Put the writer in close mode, to prevent client from sending any more requests:
jens@18
   149
    [self.writer close];
jens@18
   150
}
jens@18
   151
jens@18
   152
- (void) _receivedCloseResponse: (BLIPResponse*)response
jens@18
   153
{
jens@18
   154
    NSError *error = response.error;
jens@18
   155
    LogTo(BLIPVerbose,@"Received close response: error=%@",error);
jens@18
   156
    if( error ) {
jens@19
   157
        [self _unclose];
jens@19
   158
        [self tellDelegate: @selector(connection:closeRequestFailedWithError:) withObject: error];
jens@18
   159
    } else {
jens@18
   160
        // Now finally close the socket:
jens@18
   161
        [super _beginClose];
jens@18
   162
    }
jens@18
   163
}
jens@18
   164
jens@18
   165
jens@18
   166
- (void) _handleCloseRequest: (BLIPRequest*)request
jens@18
   167
{
jens@18
   168
    LogTo(BLIPVerbose,@"Received a close request");
jens@18
   169
    if( [_delegate respondsToSelector: @selector(connectionReceivedCloseRequest:)] )
jens@18
   170
        if( ! [_delegate connectionReceivedCloseRequest: self] ) {
jens@18
   171
            LogTo(BLIPVerbose,@"Responding with denial of close request");
jens@18
   172
            [request respondWithErrorCode: kBLIPError_Forbidden message: @"Close request denied"];
jens@18
   173
            return;
jens@18
   174
        }
jens@18
   175
    
jens@18
   176
    LogTo(BLIPVerbose,@"Close request accepted");
jens@18
   177
    _blipClosing = YES; // this prevents _beginClose from sending a close request back
jens@18
   178
    [self close];
jens@18
   179
}
jens@18
   180
jens@18
   181
jens@0
   182
@end
jens@0
   183
jens@0
   184
jens@0
   185
jens@0
   186
jens@18
   187
#pragma mark -
jens@0
   188
@implementation BLIPListener
jens@0
   189
jens@0
   190
- (id) initWithPort: (UInt16)port
jens@0
   191
{
jens@0
   192
    self = [super initWithPort: port];
jens@0
   193
    if (self != nil) {
jens@0
   194
        self.connectionClass = [BLIPConnection class];
jens@0
   195
    }
jens@0
   196
    return self;
jens@0
   197
}
jens@0
   198
jens@0
   199
- (void) dealloc
jens@0
   200
{
jens@0
   201
    [_dispatcher release];
jens@0
   202
    [super dealloc];
jens@0
   203
}
jens@0
   204
jens@0
   205
- (BLIPDispatcher*) dispatcher
jens@0
   206
{
jens@0
   207
    if( ! _dispatcher )
jens@0
   208
        _dispatcher = [[BLIPDispatcher alloc] init];
jens@0
   209
    return _dispatcher;
jens@0
   210
}
jens@0
   211
jens@0
   212
@end
jens@0
   213
jens@0
   214
jens@0
   215
/*
jens@0
   216
 Copyright (c) 2008, Jens Alfke <jens@mooseyard.com>. All rights reserved.
jens@0
   217
 
jens@0
   218
 Redistribution and use in source and binary forms, with or without modification, are permitted
jens@0
   219
 provided that the following conditions are met:
jens@0
   220
 
jens@0
   221
 * Redistributions of source code must retain the above copyright notice, this list of conditions
jens@0
   222
 and the following disclaimer.
jens@0
   223
 * Redistributions in binary form must reproduce the above copyright notice, this list of conditions
jens@0
   224
 and the following disclaimer in the documentation and/or other materials provided with the
jens@0
   225
 distribution.
jens@0
   226
 
jens@0
   227
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
jens@0
   228
 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
jens@0
   229
 FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRI-
jens@0
   230
 BUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
jens@0
   231
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
jens@0
   232
  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
jens@0
   233
 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
jens@0
   234
 THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jens@0
   235
 */