BLIP/BLIPMessage.m
author Jens Alfke <jens@mooseyard.com>
Sun Jul 13 10:52:48 2008 -0700 (2008-07-13)
changeset 20 02224e981209
parent 9 980beba83fb7
child 22 8b883753394a
permissions -rw-r--r--
* Fixed link error in BLIPClient target.
* Fixed *Ph*n* #ifdef issue (thanks, Jimmy)
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@0
    96
            _bytesWritten, sent=_sent, propertiesAvailable=_propertiesAvailable, complete=_complete;
jens@0
    97
jens@0
    98
jens@0
    99
- (void) _setFlag: (BLIPMessageFlags)flag value: (BOOL)value
jens@0
   100
{
jens@0
   101
    Assert(_isMine && _isMutable);
jens@0
   102
    if( value )
jens@0
   103
        _flags |= flag;
jens@0
   104
    else
jens@0
   105
        _flags &= ~flag;
jens@0
   106
}
jens@0
   107
jens@18
   108
- (BLIPMessageFlags) _flags                 {return _flags;}
jens@18
   109
jens@0
   110
- (BOOL) compressed                         {return (_flags & kBLIP_Compressed) != 0;}
jens@0
   111
- (BOOL) urgent                             {return (_flags & kBLIP_Urgent) != 0;}
jens@0
   112
- (void) setCompressed: (BOOL)compressed    {[self _setFlag: kBLIP_Compressed value: compressed];}
jens@0
   113
- (void) setUrgent: (BOOL)high              {[self _setFlag: kBLIP_Urgent value: high];}
jens@0
   114
jens@0
   115
jens@0
   116
- (NSData*) body
jens@0
   117
{
jens@0
   118
    if( ! _body && _isMine )
jens@0
   119
        return [[_mutableBody copy] autorelease];
jens@0
   120
    else
jens@0
   121
        return _body;
jens@0
   122
}
jens@0
   123
jens@0
   124
- (void) setBody: (NSData*)body
jens@0
   125
{
jens@0
   126
    Assert(_isMine && _isMutable);
jens@0
   127
    if( _mutableBody )
jens@0
   128
        [_mutableBody setData: body];
jens@0
   129
    else
jens@0
   130
        _mutableBody = [body mutableCopy];
jens@0
   131
}
jens@0
   132
jens@0
   133
- (void) _addToBody: (NSData*)data
jens@0
   134
{
jens@0
   135
    if( data.length ) {
jens@0
   136
        if( _mutableBody )
jens@0
   137
            [_mutableBody appendData: data];
jens@0
   138
        else
jens@0
   139
            _mutableBody = [data mutableCopy];
jens@0
   140
        setObj(&_body,nil);
jens@0
   141
    }
jens@0
   142
}
jens@0
   143
jens@0
   144
- (void) addToBody: (NSData*)data
jens@0
   145
{
jens@0
   146
    Assert(_isMine && _isMutable);
jens@0
   147
    [self _addToBody: data];
jens@0
   148
}
jens@0
   149
jens@0
   150
jens@3
   151
- (NSString*) bodyString
jens@3
   152
{
jens@3
   153
    NSData *body = self.body;
jens@3
   154
    if( body )
jens@3
   155
        return [[[NSString alloc] initWithData: body encoding: NSUTF8StringEncoding] autorelease];
jens@3
   156
    else
jens@3
   157
        return nil;
jens@3
   158
}
jens@3
   159
jens@3
   160
- (void) setBodyString: (NSString*)string
jens@3
   161
{
jens@3
   162
    self.body = [string dataUsingEncoding: NSUTF8StringEncoding];
jens@3
   163
    self.contentType = @"text/plain; charset=UTF-8";
jens@3
   164
}
jens@3
   165
jens@3
   166
jens@0
   167
- (BLIPProperties*) properties
jens@0
   168
{
jens@0
   169
    return _properties;
jens@0
   170
}
jens@0
   171
jens@0
   172
- (BLIPMutableProperties*) mutableProperties
jens@0
   173
{
jens@0
   174
    Assert(_isMine && _isMutable);
jens@0
   175
    return (BLIPMutableProperties*)_properties;
jens@0
   176
}
jens@0
   177
jens@0
   178
- (NSString*) valueOfProperty: (NSString*)property
jens@0
   179
{
jens@0
   180
    return [_properties valueOfProperty: property];
jens@0
   181
}
jens@0
   182
jens@0
   183
- (void) setValue: (NSString*)value ofProperty: (NSString*)property
jens@0
   184
{
jens@0
   185
    [self.mutableProperties setValue: value ofProperty: property];
jens@0
   186
}
jens@0
   187
jens@0
   188
- (NSString*) contentType               {return [_properties valueOfProperty: @"Content-Type"];}
jens@0
   189
- (void) setContentType: (NSString*)t   {[self setValue: t ofProperty: @"Content-Type"];}
jens@0
   190
- (NSString*) profile                   {return [_properties valueOfProperty: @"Profile"];}
jens@0
   191
- (void) setProfile: (NSString*)p       {[self setValue: p ofProperty: @"Profile"];}
jens@0
   192
jens@0
   193
jens@0
   194
#pragma mark -
jens@0
   195
#pragma mark I/O:
jens@0
   196
jens@0
   197
jens@0
   198
- (void) _encode
jens@0
   199
{
jens@0
   200
    Assert(_isMine && _isMutable);
jens@0
   201
    _isMutable = NO;
jens@0
   202
jens@0
   203
    BLIPProperties *oldProps = _properties;
jens@0
   204
    _properties = [oldProps copy];
jens@0
   205
    [oldProps release];
jens@0
   206
    
jens@0
   207
    _encodedBody = [_properties.encodedData mutableCopy];
jens@0
   208
    Assert(_encodedBody.length>=2);
jens@0
   209
jens@0
   210
    NSData *body = _body ?: _mutableBody;
jens@0
   211
    NSUInteger length = body.length;
jens@0
   212
    if( length > 0 ) {
jens@0
   213
        if( self.compressed ) {
jens@0
   214
            body = [NSData gtm_dataByGzippingData: body compressionLevel: 5];
jens@0
   215
            LogTo(BLIPVerbose,@"Compressed %@ to %u bytes (%.0f%%)", self,body.length,
jens@0
   216
                  body.length*100.0/length);
jens@0
   217
        }
jens@0
   218
        [_encodedBody appendData: body];
jens@0
   219
    }
jens@0
   220
}
jens@0
   221
jens@0
   222
jens@0
   223
- (void) _assignedNumber: (UInt32)number
jens@0
   224
{
jens@0
   225
    Assert(_number==0,@"%@ has already been sent",self);
jens@0
   226
    _number = number;
jens@0
   227
    _isMutable = NO;
jens@0
   228
}
jens@0
   229
jens@0
   230
jens@0
   231
- (BOOL) _writeFrameTo: (BLIPWriter*)writer maxSize: (UInt16)maxSize
jens@0
   232
{
jens@0
   233
    Assert(_number!=0);
jens@0
   234
    Assert(_isMine);
jens@0
   235
    Assert(_encodedBody);
jens@0
   236
    if( _bytesWritten==0 )
jens@0
   237
        LogTo(BLIP,@"Now sending %@",self);
jens@0
   238
    ssize_t lengthToWrite = _encodedBody.length - _bytesWritten;
jens@0
   239
    if( lengthToWrite <= 0 && _bytesWritten > 0 )
jens@0
   240
        return NO; // done
jens@0
   241
    Assert(maxSize > sizeof(BLIPFrameHeader));
jens@0
   242
    maxSize -= sizeof(BLIPFrameHeader);
jens@0
   243
    UInt16 flags = _flags;
jens@0
   244
    if( lengthToWrite > maxSize ) {
jens@0
   245
        lengthToWrite = maxSize;
jens@0
   246
        flags |= kBLIP_MoreComing;
jens@0
   247
        LogTo(BLIPVerbose,@"%@ pushing frame, bytes %u-%u", self, _bytesWritten, _bytesWritten+lengthToWrite);
jens@0
   248
    } else {
jens@0
   249
        flags &= ~kBLIP_MoreComing;
jens@0
   250
        LogTo(BLIPVerbose,@"%@ pushing frame, bytes %u-%u (finished)", self, _bytesWritten, _bytesWritten+lengthToWrite);
jens@0
   251
    }
jens@0
   252
        
jens@0
   253
    // First write the frame header:
jens@8
   254
    BLIPFrameHeader header = {  NSSwapHostIntToBig(kBLIPFrameHeaderMagicNumber),
jens@8
   255
                                NSSwapHostIntToBig(_number),
jens@8
   256
                                NSSwapHostShortToBig(flags),
jens@8
   257
                                NSSwapHostShortToBig(sizeof(BLIPFrameHeader) + lengthToWrite) };
jens@0
   258
    
jens@0
   259
    [writer writeData: [NSData dataWithBytes: &header length: sizeof(header)]];
jens@0
   260
    
jens@0
   261
    // Then write the body:
jens@0
   262
    if( lengthToWrite > 0 ) {
jens@9
   263
        [writer writeData: [NSData dataWithBytes: (UInt8*)_encodedBody.bytes + _bytesWritten
jens@9
   264
                                          length: lengthToWrite]];
jens@0
   265
        _bytesWritten += lengthToWrite;
jens@0
   266
    }
jens@0
   267
    return (flags & kBLIP_MoreComing) != 0;
jens@0
   268
}
jens@0
   269
jens@0
   270
jens@0
   271
- (BOOL) _receivedFrameWithHeader: (const BLIPFrameHeader*)header body: (NSData*)body
jens@0
   272
{
jens@0
   273
    Assert(!_isMine);
jens@0
   274
    AssertEq(header->number,_number);
jens@0
   275
    Assert(_flags & kBLIP_MoreComing);
jens@0
   276
    
jens@0
   277
    BLIPMessageType frameType = (header->flags & kBLIP_TypeMask), curType = (_flags & kBLIP_TypeMask);
jens@0
   278
    if( frameType != curType ) {
jens@0
   279
        Assert(curType==kBLIP_RPY && frameType==kBLIP_ERR && _mutableBody.length==0,
jens@0
   280
               @"Incoming frame's type %i doesn't match %@",frameType,self);
jens@0
   281
        _flags = (_flags & ~kBLIP_TypeMask) | frameType;
jens@0
   282
    }
jens@0
   283
jens@0
   284
    if( _encodedBody )
jens@0
   285
        [_encodedBody appendData: body];
jens@0
   286
    else
jens@0
   287
        _encodedBody = [body mutableCopy];
jens@0
   288
    LogTo(BLIPVerbose,@"%@ rcvd bytes %u-%u", self, _encodedBody.length-body.length, _encodedBody.length);
jens@0
   289
    
jens@0
   290
    if( ! _properties ) {
jens@0
   291
        // Try to extract the properties:
jens@0
   292
        ssize_t usedLength;
jens@0
   293
        setObj(&_properties, [BLIPProperties propertiesWithEncodedData: _encodedBody usedLength: &usedLength]);
jens@0
   294
        if( _properties ) {
jens@0
   295
            [_encodedBody replaceBytesInRange: NSMakeRange(0,usedLength)
jens@0
   296
                                    withBytes: NULL length: 0];
jens@0
   297
        } else if( usedLength < 0 )
jens@0
   298
            return NO;
jens@0
   299
        self.propertiesAvailable = YES;
jens@0
   300
    }
jens@0
   301
    
jens@0
   302
    if( ! (header->flags & kBLIP_MoreComing) ) {
jens@0
   303
        // After last frame, decode the data:
jens@0
   304
        _flags &= ~kBLIP_MoreComing;
jens@0
   305
        if( ! _properties )
jens@0
   306
            return NO;
jens@0
   307
        unsigned encodedLength = _encodedBody.length;
jens@0
   308
        if( self.compressed && encodedLength>0 ) {
jens@0
   309
            _body = [[NSData gtm_dataByInflatingData: _encodedBody] copy];
jens@0
   310
            if( ! _body )
jens@0
   311
                return NO;
jens@0
   312
            LogTo(BLIPVerbose,@"Uncompressed %@ from %u bytes (%.1fx)", self, encodedLength,
jens@0
   313
                  _body.length/(float)encodedLength);
jens@0
   314
        } else {
jens@0
   315
            _body = [_encodedBody copy];
jens@0
   316
        }
jens@0
   317
        setObj(&_encodedBody,nil);
jens@0
   318
        self.propertiesAvailable = self.complete = YES;
jens@0
   319
    }
jens@0
   320
    return YES;
jens@0
   321
}
jens@0
   322
jens@0
   323
jens@0
   324
- (void) _connectionClosed
jens@0
   325
{
jens@0
   326
    if( _isMine ) {
jens@0
   327
        _bytesWritten = 0;
jens@0
   328
        _flags |= kBLIP_MoreComing;
jens@0
   329
    }
jens@0
   330
}
jens@0
   331
jens@0
   332
jens@0
   333
@end
jens@0
   334
jens@0
   335
jens@0
   336
/*
jens@0
   337
 Copyright (c) 2008, Jens Alfke <jens@mooseyard.com>. All rights reserved.
jens@0
   338
 
jens@0
   339
 Redistribution and use in source and binary forms, with or without modification, are permitted
jens@0
   340
 provided that the following conditions are met:
jens@0
   341
 
jens@0
   342
 * Redistributions of source code must retain the above copyright notice, this list of conditions
jens@0
   343
 and the following disclaimer.
jens@0
   344
 * Redistributions in binary form must reproduce the above copyright notice, this list of conditions
jens@0
   345
 and the following disclaimer in the documentation and/or other materials provided with the
jens@0
   346
 distribution.
jens@0
   347
 
jens@0
   348
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
jens@0
   349
 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
jens@0
   350
 FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRI-
jens@0
   351
 BUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
jens@0
   352
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
jens@0
   353
  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
jens@0
   354
 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
jens@0
   355
 THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jens@0
   356
 */