BLIP/BLIPConnection.m
author morrowa
Tue Jun 23 13:52:28 2009 -0700 (2009-06-23)
changeset 54 6d1392a3e0a6
parent 19 16454d63d4c2
child 63 5e4855a592ee
permissions -rw-r--r--
Moved _handleCloseRequest to a new method. Added warning messages.
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@49
   124
    if (!request.isMine || request.sent) {
jens@49
   125
        // This was an incoming request that I'm being asked to forward or echo;
jens@49
   126
        // or it's an outgoing request being sent to multiple connections.
jens@49
   127
        // Since a particular BLIPRequest can only be sent once, make a copy of it to send:
jens@49
   128
        request = [[request mutableCopy] autorelease];
jens@49
   129
    }
jens@0
   130
    BLIPConnection *itsConnection = request.connection;
jens@0
   131
    if( itsConnection==nil )
jens@0
   132
        request.connection = self;
jens@0
   133
    else
jens@0
   134
        Assert(itsConnection==self,@"%@ is already assigned to a different BLIPConnection",request);
jens@0
   135
    return [request send];
jens@0
   136
}
jens@0
   137
jens@0
   138
jens@18
   139
#pragma mark -
jens@18
   140
#pragma mark CLOSING:
jens@18
   141
jens@18
   142
jens@18
   143
- (void) _beginClose
jens@18
   144
{
jens@18
   145
    // Override of TCPConnection method. Instead of closing the socket, send a 'bye' request:
jens@18
   146
    if( ! _blipClosing ) {
jens@18
   147
        LogTo(BLIPVerbose,@"Sending close request...");
jens@18
   148
        BLIPRequest *r = [self request];
jens@18
   149
        [r _setFlag: kBLIP_Meta value: YES];
jens@18
   150
        r.profile = kBLIPProfile_Bye;
jens@18
   151
        BLIPResponse *response = [r send];
jens@18
   152
        response.onComplete = $target(self,_receivedCloseResponse:);
jens@18
   153
    }
jens@18
   154
    // Put the writer in close mode, to prevent client from sending any more requests:
jens@18
   155
    [self.writer close];
jens@18
   156
}
jens@18
   157
jens@18
   158
- (void) _receivedCloseResponse: (BLIPResponse*)response
jens@18
   159
{
jens@18
   160
    NSError *error = response.error;
jens@18
   161
    LogTo(BLIPVerbose,@"Received close response: error=%@",error);
jens@18
   162
    if( error ) {
jens@19
   163
        [self _unclose];
jens@19
   164
        [self tellDelegate: @selector(connection:closeRequestFailedWithError:) withObject: error];
jens@18
   165
    } else {
jens@18
   166
        // Now finally close the socket:
jens@18
   167
        [super _beginClose];
jens@18
   168
    }
jens@18
   169
}
jens@18
   170
jens@18
   171
jens@18
   172
- (void) _handleCloseRequest: (BLIPRequest*)request
jens@18
   173
{
jens@18
   174
    LogTo(BLIPVerbose,@"Received a close request");
jens@18
   175
    if( [_delegate respondsToSelector: @selector(connectionReceivedCloseRequest:)] )
jens@18
   176
        if( ! [_delegate connectionReceivedCloseRequest: self] ) {
jens@18
   177
            LogTo(BLIPVerbose,@"Responding with denial of close request");
jens@18
   178
            [request respondWithErrorCode: kBLIPError_Forbidden message: @"Close request denied"];
jens@18
   179
            return;
jens@18
   180
        }
jens@18
   181
    
jens@18
   182
    LogTo(BLIPVerbose,@"Close request accepted");
jens@18
   183
    _blipClosing = YES; // this prevents _beginClose from sending a close request back
jens@18
   184
    [self close];
jens@18
   185
}
jens@18
   186
jens@18
   187
jens@0
   188
@end
jens@0
   189
jens@0
   190
jens@0
   191
jens@0
   192
jens@18
   193
#pragma mark -
jens@0
   194
@implementation BLIPListener
jens@0
   195
jens@49
   196
- (id) init
jens@0
   197
{
jens@49
   198
    self = [super init];
jens@0
   199
    if (self != nil) {
jens@0
   200
        self.connectionClass = [BLIPConnection class];
jens@0
   201
    }
jens@0
   202
    return self;
jens@0
   203
}
jens@0
   204
jens@0
   205
- (void) dealloc
jens@0
   206
{
jens@0
   207
    [_dispatcher release];
jens@0
   208
    [super dealloc];
jens@0
   209
}
jens@0
   210
jens@0
   211
- (BLIPDispatcher*) dispatcher
jens@0
   212
{
jens@0
   213
    if( ! _dispatcher )
jens@0
   214
        _dispatcher = [[BLIPDispatcher alloc] init];
jens@0
   215
    return _dispatcher;
jens@0
   216
}
jens@0
   217
jens@0
   218
@end
jens@0
   219
jens@0
   220
jens@0
   221
/*
jens@0
   222
 Copyright (c) 2008, Jens Alfke <jens@mooseyard.com>. All rights reserved.
jens@0
   223
 
jens@0
   224
 Redistribution and use in source and binary forms, with or without modification, are permitted
jens@0
   225
 provided that the following conditions are met:
jens@0
   226
 
jens@0
   227
 * Redistributions of source code must retain the above copyright notice, this list of conditions
jens@0
   228
 and the following disclaimer.
jens@0
   229
 * Redistributions in binary form must reproduce the above copyright notice, this list of conditions
jens@0
   230
 and the following disclaimer in the documentation and/or other materials provided with the
jens@0
   231
 distribution.
jens@0
   232
 
jens@0
   233
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
jens@0
   234
 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
jens@0
   235
 FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRI-
jens@0
   236
 BUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
jens@0
   237
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
jens@0
   238
  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
jens@0
   239
 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
jens@0
   240
 THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jens@0
   241
 */