BLIP/BLIPMessage.m
author Jens Alfke <jens@mooseyard.com>
Sun May 24 15:03:39 2009 -0700 (2009-05-24)
changeset 49 20cccc7c26ee
parent 18 3be241de1630
child 50 63baa74c903f
permissions -rw-r--r--
Misc. tweaks made while porting Chatty to use MYNetwork.
* Allow -[BLIPConnection sendRequest:] to re-send an already-sent or received request.
* Allow use of the basic -init method for BLIPConnection.
* Some new convenience factory methods.
* Broke dependencies on Security.framework out into new TCPEndpoint+Certs.m source file, so client apps aren't forced to link against Security.
jens@0
     1
//
jens@0
     2
//  BLIPMessage.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 "BLIPMessage.h"
jens@0
    10
#import "BLIP_Internal.h"
jens@0
    11
#import "BLIPReader.h"
jens@0
    12
#import "BLIPWriter.h"
jens@0
    13
jens@1
    14
#import "Logging.h"
jens@1
    15
#import "Test.h"
jens@0
    16
#import "ExceptionUtils.h"
jens@0
    17
#import "Target.h"
jens@0
    18
jens@0
    19
// From Google Toolbox For Mac <http://code.google.com/p/google-toolbox-for-mac/>
jens@0
    20
#import "GTMNSData+zlib.h"
jens@0
    21
jens@0
    22
jens@0
    23
@implementation BLIPMessage
jens@0
    24
jens@0
    25
jens@0
    26
- (id) _initWithConnection: (BLIPConnection*)connection
jens@0
    27
                    isMine: (BOOL)isMine
jens@0
    28
                     flags: (BLIPMessageFlags)flags
jens@0
    29
                    number: (UInt32)msgNo
jens@0
    30
                      body: (NSData*)body
jens@0
    31
{
jens@0
    32
    self = [super init];
jens@0
    33
    if (self != nil) {
jens@0
    34
        _connection = [connection retain];
jens@0
    35
        _isMine = isMine;
jens@0
    36
        _flags = flags;
jens@0
    37
        _number = msgNo;
jens@0
    38
        if( isMine ) {
jens@0
    39
            _body = body.copy;
jens@0
    40
            _properties = [[BLIPMutableProperties alloc] init];
jens@0
    41
            _propertiesAvailable = YES;
jens@0
    42
        } else {
jens@0
    43
            _encodedBody = body.mutableCopy;
jens@0
    44
        }
jens@0
    45
        LogTo(BLIPVerbose,@"INIT %@",self);
jens@0
    46
    }
jens@0
    47
    return self;
jens@0
    48
}
jens@0
    49
jens@0
    50
- (void) dealloc
jens@0
    51
{
jens@0
    52
    LogTo(BLIPVerbose,@"DEALLOC %@",self);
jens@0
    53
    [_properties release];
jens@0
    54
    [_encodedBody release];
jens@0
    55
    [_mutableBody release];
jens@0
    56
    [_body release];
jens@0
    57
    [_connection release];
jens@0
    58
    [super dealloc];
jens@0
    59
}
jens@0
    60
jens@0
    61
jens@0
    62
- (NSString*) description
jens@0
    63
{
jens@0
    64
    NSUInteger length = (_body.length ?: _mutableBody.length) ?: _encodedBody.length;
jens@0
    65
    NSMutableString *desc = [NSMutableString stringWithFormat: @"%@[#%u, %u bytes",
jens@0
    66
                             self.class,_number, length];
jens@0
    67
    if( _flags & kBLIP_Compressed ) {
jens@0
    68
        if( _encodedBody && _encodedBody.length != length )
jens@0
    69
            [desc appendFormat: @" (%u gzipped)", _encodedBody.length];
jens@0
    70
        else
jens@0
    71
            [desc appendString: @", gzipped"];
jens@0
    72
    }
jens@0
    73
    if( _flags & kBLIP_Urgent )
jens@0
    74
        [desc appendString: @", urgent"];
jens@0
    75
    if( _flags & kBLIP_NoReply )
jens@0
    76
        [desc appendString: @", noreply"];
jens@18
    77
    if( _flags & kBLIP_Meta )
jens@18
    78
        [desc appendString: @", META"];
jens@0
    79
    [desc appendString: @"]"];
jens@0
    80
    return desc;
jens@0
    81
}
jens@0
    82
jens@0
    83
- (NSString*) descriptionWithProperties
jens@0
    84
{
jens@0
    85
    NSMutableString *desc = (NSMutableString*)self.description;
jens@0
    86
    [desc appendFormat: @" %@", self.properties.allProperties];
jens@0
    87
    return desc;
jens@0
    88
}
jens@0
    89
jens@0
    90
jens@0
    91
#pragma mark -
jens@0
    92
#pragma mark PROPERTIES & METADATA:
jens@0
    93
jens@0
    94
jens@0
    95
@synthesize connection=_connection, number=_number, isMine=_isMine, isMutable=_isMutable,
jens@22
    96
            _bytesWritten, sent=_sent, propertiesAvailable=_propertiesAvailable, complete=_complete,
jens@22
    97
            representedObject=_representedObject;
jens@0
    98
jens@0
    99
jens@0
   100
- (void) _setFlag: (BLIPMessageFlags)flag value: (BOOL)value
jens@0
   101
{
jens@0
   102
    Assert(_isMine && _isMutable);
jens@0
   103
    if( value )
jens@0
   104
        _flags |= flag;
jens@0
   105
    else
jens@0
   106
        _flags &= ~flag;
jens@0
   107
}
jens@0
   108
jens@18
   109
- (BLIPMessageFlags) _flags                 {return _flags;}
jens@18
   110
jens@0
   111
- (BOOL) compressed                         {return (_flags & kBLIP_Compressed) != 0;}
jens@0
   112
- (BOOL) urgent                             {return (_flags & kBLIP_Urgent) != 0;}
jens@0
   113
- (void) setCompressed: (BOOL)compressed    {[self _setFlag: kBLIP_Compressed value: compressed];}
jens@0
   114
- (void) setUrgent: (BOOL)high              {[self _setFlag: kBLIP_Urgent value: high];}
jens@0
   115
jens@0
   116
jens@0
   117
- (NSData*) body
jens@0
   118
{
jens@0
   119
    if( ! _body && _isMine )
jens@0
   120
        return [[_mutableBody copy] autorelease];
jens@0
   121
    else
jens@0
   122
        return _body;
jens@0
   123
}
jens@0
   124
jens@0
   125
- (void) setBody: (NSData*)body
jens@0
   126
{
jens@0
   127
    Assert(_isMine && _isMutable);
jens@0
   128
    if( _mutableBody )
jens@0
   129
        [_mutableBody setData: body];
jens@0
   130
    else
jens@0
   131
        _mutableBody = [body mutableCopy];
jens@0
   132
}
jens@0
   133
jens@0
   134
- (void) _addToBody: (NSData*)data
jens@0
   135
{
jens@0
   136
    if( data.length ) {
jens@0
   137
        if( _mutableBody )
jens@0
   138
            [_mutableBody appendData: data];
jens@0
   139
        else
jens@0
   140
            _mutableBody = [data mutableCopy];
jens@0
   141
        setObj(&_body,nil);
jens@0
   142
    }
jens@0
   143
}
jens@0
   144
jens@0
   145
- (void) addToBody: (NSData*)data
jens@0
   146
{
jens@0
   147
    Assert(_isMine && _isMutable);
jens@0
   148
    [self _addToBody: data];
jens@0
   149
}
jens@0
   150
jens@0
   151
jens@3
   152
- (NSString*) bodyString
jens@3
   153
{
jens@3
   154
    NSData *body = self.body;
jens@3
   155
    if( body )
jens@3
   156
        return [[[NSString alloc] initWithData: body encoding: NSUTF8StringEncoding] autorelease];
jens@3
   157
    else
jens@3
   158
        return nil;
jens@3
   159
}
jens@3
   160
jens@3
   161
- (void) setBodyString: (NSString*)string
jens@3
   162
{
jens@3
   163
    self.body = [string dataUsingEncoding: NSUTF8StringEncoding];
jens@3
   164
    self.contentType = @"text/plain; charset=UTF-8";
jens@3
   165
}
jens@3
   166
jens@3
   167
jens@0
   168
- (BLIPProperties*) properties
jens@0
   169
{
jens@0
   170
    return _properties;
jens@0
   171
}
jens@0
   172
jens@0
   173
- (BLIPMutableProperties*) mutableProperties
jens@0
   174
{
jens@0
   175
    Assert(_isMine && _isMutable);
jens@0
   176
    return (BLIPMutableProperties*)_properties;
jens@0
   177
}
jens@0
   178
jens@0
   179
- (NSString*) valueOfProperty: (NSString*)property
jens@0
   180
{
jens@0
   181
    return [_properties valueOfProperty: property];
jens@0
   182
}
jens@0
   183
jens@0
   184
- (void) setValue: (NSString*)value ofProperty: (NSString*)property
jens@0
   185
{
jens@0
   186
    [self.mutableProperties setValue: value ofProperty: property];
jens@0
   187
}
jens@0
   188
jens@0
   189
- (NSString*) contentType               {return [_properties valueOfProperty: @"Content-Type"];}
jens@0
   190
- (void) setContentType: (NSString*)t   {[self setValue: t ofProperty: @"Content-Type"];}
jens@0
   191
- (NSString*) profile                   {return [_properties valueOfProperty: @"Profile"];}
jens@0
   192
- (void) setProfile: (NSString*)p       {[self setValue: p ofProperty: @"Profile"];}
jens@0
   193
jens@0
   194
jens@0
   195
#pragma mark -
jens@0
   196
#pragma mark I/O:
jens@0
   197
jens@0
   198
jens@0
   199
- (void) _encode
jens@0
   200
{
jens@0
   201
    Assert(_isMine && _isMutable);
jens@0
   202
    _isMutable = NO;
jens@0
   203
jens@0
   204
    BLIPProperties *oldProps = _properties;
jens@0
   205
    _properties = [oldProps copy];
jens@0
   206
    [oldProps release];
jens@0
   207
    
jens@0
   208
    _encodedBody = [_properties.encodedData mutableCopy];
jens@0
   209
    Assert(_encodedBody.length>=2);
jens@0
   210
jens@0
   211
    NSData *body = _body ?: _mutableBody;
jens@0
   212
    NSUInteger length = body.length;
jens@0
   213
    if( length > 0 ) {
jens@0
   214
        if( self.compressed ) {
jens@0
   215
            body = [NSData gtm_dataByGzippingData: body compressionLevel: 5];
jens@0
   216
            LogTo(BLIPVerbose,@"Compressed %@ to %u bytes (%.0f%%)", self,body.length,
jens@0
   217
                  body.length*100.0/length);
jens@0
   218
        }
jens@0
   219
        [_encodedBody appendData: body];
jens@0
   220
    }
jens@0
   221
}
jens@0
   222
jens@0
   223
jens@0
   224
- (void) _assignedNumber: (UInt32)number
jens@0
   225
{
jens@0
   226
    Assert(_number==0,@"%@ has already been sent",self);
jens@0
   227
    _number = number;
jens@0
   228
    _isMutable = NO;
jens@0
   229
}
jens@0
   230
jens@0
   231
jens@0
   232
- (BOOL) _writeFrameTo: (BLIPWriter*)writer maxSize: (UInt16)maxSize
jens@0
   233
{
jens@0
   234
    Assert(_number!=0);
jens@0
   235
    Assert(_isMine);
jens@0
   236
    Assert(_encodedBody);
jens@0
   237
    if( _bytesWritten==0 )
jens@0
   238
        LogTo(BLIP,@"Now sending %@",self);
jens@0
   239
    ssize_t lengthToWrite = _encodedBody.length - _bytesWritten;
jens@0
   240
    if( lengthToWrite <= 0 && _bytesWritten > 0 )
jens@0
   241
        return NO; // done
jens@0
   242
    Assert(maxSize > sizeof(BLIPFrameHeader));
jens@0
   243
    maxSize -= sizeof(BLIPFrameHeader);
jens@0
   244
    UInt16 flags = _flags;
jens@0
   245
    if( lengthToWrite > maxSize ) {
jens@0
   246
        lengthToWrite = maxSize;
jens@0
   247
        flags |= kBLIP_MoreComing;
jens@0
   248
        LogTo(BLIPVerbose,@"%@ pushing frame, bytes %u-%u", self, _bytesWritten, _bytesWritten+lengthToWrite);
jens@0
   249
    } else {
jens@0
   250
        flags &= ~kBLIP_MoreComing;
jens@0
   251
        LogTo(BLIPVerbose,@"%@ pushing frame, bytes %u-%u (finished)", self, _bytesWritten, _bytesWritten+lengthToWrite);
jens@0
   252
    }
jens@0
   253
        
jens@0
   254
    // First write the frame header:
jens@8
   255
    BLIPFrameHeader header = {  NSSwapHostIntToBig(kBLIPFrameHeaderMagicNumber),
jens@8
   256
                                NSSwapHostIntToBig(_number),
jens@8
   257
                                NSSwapHostShortToBig(flags),
jens@8
   258
                                NSSwapHostShortToBig(sizeof(BLIPFrameHeader) + lengthToWrite) };
jens@0
   259
    
jens@0
   260
    [writer writeData: [NSData dataWithBytes: &header length: sizeof(header)]];
jens@0
   261
    
jens@0
   262
    // Then write the body:
jens@0
   263
    if( lengthToWrite > 0 ) {
jens@9
   264
        [writer writeData: [NSData dataWithBytes: (UInt8*)_encodedBody.bytes + _bytesWritten
jens@9
   265
                                          length: lengthToWrite]];
jens@0
   266
        _bytesWritten += lengthToWrite;
jens@0
   267
    }
jens@0
   268
    return (flags & kBLIP_MoreComing) != 0;
jens@0
   269
}
jens@0
   270
jens@0
   271
jens@0
   272
- (BOOL) _receivedFrameWithHeader: (const BLIPFrameHeader*)header body: (NSData*)body
jens@0
   273
{
jens@0
   274
    Assert(!_isMine);
jens@0
   275
    AssertEq(header->number,_number);
jens@0
   276
    Assert(_flags & kBLIP_MoreComing);
jens@0
   277
    
jens@0
   278
    BLIPMessageType frameType = (header->flags & kBLIP_TypeMask), curType = (_flags & kBLIP_TypeMask);
jens@0
   279
    if( frameType != curType ) {
jens@0
   280
        Assert(curType==kBLIP_RPY && frameType==kBLIP_ERR && _mutableBody.length==0,
jens@0
   281
               @"Incoming frame's type %i doesn't match %@",frameType,self);
jens@0
   282
        _flags = (_flags & ~kBLIP_TypeMask) | frameType;
jens@0
   283
    }
jens@0
   284
jens@0
   285
    if( _encodedBody )
jens@0
   286
        [_encodedBody appendData: body];
jens@0
   287
    else
jens@0
   288
        _encodedBody = [body mutableCopy];
jens@0
   289
    LogTo(BLIPVerbose,@"%@ rcvd bytes %u-%u", self, _encodedBody.length-body.length, _encodedBody.length);
jens@0
   290
    
jens@0
   291
    if( ! _properties ) {
jens@0
   292
        // Try to extract the properties:
jens@0
   293
        ssize_t usedLength;
jens@0
   294
        setObj(&_properties, [BLIPProperties propertiesWithEncodedData: _encodedBody usedLength: &usedLength]);
jens@0
   295
        if( _properties ) {
jens@0
   296
            [_encodedBody replaceBytesInRange: NSMakeRange(0,usedLength)
jens@0
   297
                                    withBytes: NULL length: 0];
jens@0
   298
        } else if( usedLength < 0 )
jens@0
   299
            return NO;
jens@0
   300
        self.propertiesAvailable = YES;
jens@0
   301
    }
jens@0
   302
    
jens@0
   303
    if( ! (header->flags & kBLIP_MoreComing) ) {
jens@0
   304
        // After last frame, decode the data:
jens@0
   305
        _flags &= ~kBLIP_MoreComing;
jens@0
   306
        if( ! _properties )
jens@0
   307
            return NO;
jens@0
   308
        unsigned encodedLength = _encodedBody.length;
jens@0
   309
        if( self.compressed && encodedLength>0 ) {
jens@0
   310
            _body = [[NSData gtm_dataByInflatingData: _encodedBody] copy];
jens@0
   311
            if( ! _body )
jens@0
   312
                return NO;
jens@0
   313
            LogTo(BLIPVerbose,@"Uncompressed %@ from %u bytes (%.1fx)", self, encodedLength,
jens@0
   314
                  _body.length/(float)encodedLength);
jens@0
   315
        } else {
jens@0
   316
            _body = [_encodedBody copy];
jens@0
   317
        }
jens@0
   318
        setObj(&_encodedBody,nil);
jens@0
   319
        self.propertiesAvailable = self.complete = YES;
jens@0
   320
    }
jens@0
   321
    return YES;
jens@0
   322
}
jens@0
   323
jens@0
   324
jens@0
   325
- (void) _connectionClosed
jens@0
   326
{
jens@0
   327
    if( _isMine ) {
jens@0
   328
        _bytesWritten = 0;
jens@0
   329
        _flags |= kBLIP_MoreComing;
jens@0
   330
    }
jens@0
   331
}
jens@0
   332
jens@0
   333
jens@0
   334
@end
jens@0
   335
jens@0
   336
jens@0
   337
/*
jens@0
   338
 Copyright (c) 2008, Jens Alfke <jens@mooseyard.com>. All rights reserved.
jens@0
   339
 
jens@0
   340
 Redistribution and use in source and binary forms, with or without modification, are permitted
jens@0
   341
 provided that the following conditions are met:
jens@0
   342
 
jens@0
   343
 * Redistributions of source code must retain the above copyright notice, this list of conditions
jens@0
   344
 and the following disclaimer.
jens@0
   345
 * Redistributions in binary form must reproduce the above copyright notice, this list of conditions
jens@0
   346
 and the following disclaimer in the documentation and/or other materials provided with the
jens@0
   347
 distribution.
jens@0
   348
 
jens@0
   349
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
jens@0
   350
 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
jens@0
   351
 FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRI-
jens@0
   352
 BUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
jens@0
   353
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
jens@0
   354
  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
jens@0
   355
 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
jens@0
   356
 THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jens@0
   357
 */