err.no Git - sope/blob - sope-mime/NGMime/NGMimeMultipartBody.h

   1 /*
   2   Copyright (C) 2000-2005 SKYRIX Software AG
   3
   4   This file is part of SOPE.
   5
   6   SOPE is free software; you can redistribute it and/or modify it under
   7   the terms of the GNU Lesser General Public License as published by the
   8   Free Software Foundation; either version 2, or (at your option) any
   9   later version.
  10
  11   SOPE is distributed in the hope that it will be useful, but WITHOUT ANY
  12   WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13   FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
  14   License for more details.
  15
  16   You should have received a copy of the GNU Lesser General Public
  17   License along with SOPE; see the file COPYING.  If not, write to the
  18   Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  19   02111-1307, USA.
  20 */
  21
  22 #ifndef __NGMime_NGMimeMultipartBody_H__
  23 #define __NGMime_NGMimeMultipartBody_H__
  24
  25 #import <Foundation/NSObject.h>
  26 #include <NGMime/NGPart.h>
  27
  28 @class NSData, NSString, NSMutableArray;
  29
  30 /*
  31   Represents bodies of multipart entities.
  32   Multipart bodies can be parsed 'on-demand'.
  33
  34   ATTENTION: the delegate is _required_ to persist until the multipart body
  35              is parsed ! The body does not retain the delegate.
  36 */
  37
  38 @interface NGMimeMultipartBody : NSObject
  39 {
  40 @protected
  41   id<NGMimePart> part;     /* non-retained */
  42   NSString       *prefix;
  43   NSString       *suffix;
  44   NSMutableArray *bodyParts;
  45
  46   // for on-demand parsing
  47   NSData         *rawData;
  48   id             delegate; /* non-retained */
  49
  50   struct {
  51     BOOL isParsed:1;
  52   } flags;
  53 }
  54
  55 - (id)initWithPart:(id<NGMimePart>)_part; // designated initializer
  56 - (id)initWithPart:(id<NGMimePart>)_part
  57   data:(NSData *)_data
  58   delegate:(id)_delegate;
  59
  60 // accessors
  61
  62 - (id<NGMimePart>)part; // the part the body belongs to
  63
  64 - (NSArray *)parts;
  65 - (void)addBodyPart:(id<NGPart>)_part;
  66 - (void)addBodyPart:(id<NGPart>)_part atIndex:(int)_idx;
  67 - (void)removeBodyPart:(id<NGPart>)_part;
  68 - (void)removeBodyPartAtIndex:(int)_idx;
  69
  70 - (void)setPrefix:(NSString *)_prefix;
  71 - (NSString *)prefix;
  72 - (void)setSuffix:(NSString *)_suffix;
  73 - (NSString *)suffix;
  74
  75 @end
  76
  77 #endif /* __NGMime_NGMimeMultipartBody_H__ */