开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 多媒体 > IP电话/视频会议 > 查看源码
asner.h
资源名称：pwlib_1.1pl17.zip　[点击查看]
上传用户：hzhsqp
上传日期：2007-01-06
资源大小：1600k
文件大小：35k
源码类别：

IP电话/视频会议

开发平台：

Visual C++

asner.h：源码内容
  1. /*
  2.  * asner.h
  3.  *
  4.  * Abstract Syntax Notation Encoding Rules classes
  5.  *
  6.  * Portable Windows Library
  7.  *
  8.  * Copyright (c) 1993-1998 Equivalence Pty. Ltd.
  9.  *
  10.  * The contents of this file are subject to the Mozilla Public License
  11.  * Version 1.0 (the "License"); you may not use this file except in
  12.  * compliance with the License. You may obtain a copy of the License at
  13.  * http://www.mozilla.org/MPL/
  14.  *
  15.  * Software distributed under the License is distributed on an "AS IS"
  16.  * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
  17.  * the License for the specific language governing rights and limitations
  18.  * under the License.
  19.  *
  20.  * The Original Code is Portable Windows Library.
  21.  *
  22.  * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
  23.  *
  24.  * Portions are Copyright (C) 1993 Free Software Foundation, Inc.
  25.  * All Rights Reserved.
  26.  *
  27.  * Contributor(s): ______________________________________.
  28.  *
  29.  * $Log: asner.h,v $
  30.  * Revision 1.13  2000/07/11 18:23:03  robertj
  31.  * Added ability to set/get BMP string data as PWORDArray.
  32.  *
  33.  * Revision 1.12  2000/04/10 17:30:42  robertj
  34.  * Added [] operator for char access on ASN string classes.
  35.  *
  36.  * Revision 1.11  2000/02/29 06:32:12  robertj
  37.  * Added ability to remove optional field in sequence, thanks Dave Harvey.
  38.  *
  39.  * Revision 1.10  1999/08/09 13:02:45  robertj
  40.  * dded ASN compiler #defines for backward support of pre GCC 2.9 compilers.
  41.  * Added ASN compiler #defines to reduce its memory footprint.
  42.  *
  43.  * Revision 1.9  1999/07/22 06:48:51  robertj
  44.  * Added comparison operation to base ASN classes and compiled ASN code.
  45.  * Added support for ANY type in ASN parser.
  46.  *
  47.  * Revision 1.8  1999/03/09 09:34:05  robertj
  48.  * Fixed typo's.
  49.  *
  50.  * Revision 1.7  1999/03/09 08:01:46  robertj
  51.  * Changed comments for doc++ support (more to come).
  52.  *
  53.  * Revision 1.6  1998/09/23 06:19:21  robertj
  54.  * Added open source copyright license.
  55.  *
  56.  * Revision 1.5  1998/05/21 04:26:53  robertj
  57.  * Fixed numerous PER problems.
  58.  *
  59.  * Revision 1.4  1998/05/07 05:19:28  robertj
  60.  * Fixed problems with using copy constructor/assignment oeprator on PASN_Objects.
  61.  *
  62.  * Revision 1.3  1997/12/18 05:08:13  robertj
  63.  * Added function to get choice discriminator name.
  64.  *
  65.  * Revision 1.2  1997/12/11 10:35:42  robertj
  66.  * Support for new ASN file parser.
  67.  *
  68.  */
  70. #ifndef _ASNER_H
  71. #define _ASNER_H
  73. #ifdef __GNUC__
  74. #pragma interface
  75. #endif
  78. class PASN_Stream;
  79. class PBER_Stream;
  80. class PPER_Stream;
  83. /////////////////////////////////////////////////////////////////////////////
  85. /** Base class for ASN encoding/decoding.
  86. */
  87. class PASN_Object : public PObject
  88. {
  89.     PCLASSINFO(PASN_Object, PObject);
  90.   public:
  91.     /** Return a string giving the type of the object */
  92.     virtual PString GetTypeAsString() const = 0;
  94.     PINDEX GetObjectLength() const;
  95.     virtual PINDEX GetDataLength() const = 0;
  96.     virtual BOOL IsPrimitive() const { return TRUE; }
  98.     virtual BOOL Decode(PASN_Stream &) = 0;
  99.     virtual void Encode(PASN_Stream &) const = 0;
  101.     BOOL IsExtendable() const { return extendable; }
  102.     void SetExtendable(BOOL ext = TRUE) { extendable = ext; }
  104.     enum TagClass {
  105.       UniversalTagClass,
  106.       ApplicationTagClass,
  107.       ContextSpecificTagClass,
  108.       PrivateTagClass,
  109.       DefaultTagClass
  110.     };
  111.     TagClass GetTagClass() const { return tagClass; }
  113.     enum UniversalTags {
  114.       InvalidUniversalTag,
  115.       UniversalBoolean,
  116.       UniversalInteger,
  117.       UniversalBitString,
  118.       UniversalOctetString,
  119.       UniversalNull,
  120.       UniversalObjectId,
  121.       UniversalObjectDescriptor,
  122.       UniversalExternalType,
  123.       UniversalReal,
  124.       UniversalEnumeration,
  125.       UniversalEmbeddedPDV,
  126.       UniversalSequence = 16,
  127.       UniversalSet,
  128.       UniversalNumericString,
  129.       UniversalPrintableString,
  130.       UniversalTeletexString,
  131.       UniversalVideotexString,
  132.       UniversalIA5String,
  133.       UniversalUTCTime,
  134.       UniversalGeneralisedTime,
  135.       UniversalGraphicString,
  136.       UniversalVisibleString,
  137.       UniversalGeneralString,
  138.       UniversalUniversalString,
  139.       UniversalBMPString = 30
  140.     };
  142.     unsigned GetTag() const  { return tag; }
  143.     virtual void SetTag(unsigned newTag, TagClass tagClass = DefaultTagClass);
  145.     enum ConstraintType {
  146.       Unconstrained,
  147.       PartiallyConstrained,
  148.       FixedConstraint,
  149.       ExtendableConstraint
  150.     };
  152.     enum MinimumValueTag { MinimumValue = INT_MIN };
  153.     enum MaximumValueTag { MaximumValue = INT_MAX };
  154.     void SetConstraints(ConstraintType type, int lower, MaximumValueTag upper);
  155.     void SetConstraints(ConstraintType type, MinimumValueTag lower, unsigned upper);
  156.     void SetConstraints(ConstraintType type, MinimumValueTag lower, MaximumValueTag upper);
  157.     virtual void SetConstraints(ConstraintType type, int lower = 0, unsigned upper = UINT_MAX);
  158.     virtual void SetCharacterSet(ConstraintType ctype, const char * charSet);
  159.     virtual void SetCharacterSet(ConstraintType ctype, unsigned firstChar, unsigned lastChar);
  161.   protected:
  162.     PASN_Object(unsigned tag, TagClass tagClass, BOOL extend = FALSE);
  164.     /// PER extension capability
  165.     BOOL extendable;
  166.     /// BER tag class
  167.     TagClass tagClass;
  168.     /// ASN object tag
  169.     unsigned tag;
  170. };
  173. /** Base class for constrained ASN encoding/decoding.
  174. */
  175. class PASN_ConstrainedObject : public PASN_Object
  176. {
  177.     PCLASSINFO(PASN_ConstrainedObject, PASN_Object);
  178.   public:
  179.     virtual void SetConstraints(ConstraintType type, int lower = 0, unsigned upper = UINT_MAX);
  180.     BOOL IsConstrained() const { return constraint != Unconstrained; }
  181.     int GetLowerLimit() const { return lowerLimit; }
  182.     unsigned GetUpperLimit() const { return upperLimit; }
  184.     int ConstrainedLengthDecode(PPER_Stream & strm, unsigned & length);
  185.     void ConstrainedLengthEncode(PPER_Stream & strm, unsigned length) const;
  187.     BOOL ConstraintEncode(PPER_Stream & strm, unsigned value) const;
  189.   protected:
  190.     PASN_ConstrainedObject(unsigned tag, TagClass tagClass);
  192.     ConstraintType constraint;
  193.     int lowerLimit;
  194.     unsigned upperLimit;
  195. };
  198. /** Class for ASN Null type.
  199. */
  200. class PASN_Null : public PASN_Object
  201. {
  202.     PCLASSINFO(PASN_Null, PASN_Object);
  203.   public:
  204.     PASN_Null(unsigned tag = UniversalNull,
  205.               TagClass tagClass = UniversalTagClass);
  207.     virtual Comparison Compare(const PObject & obj) const;
  208.     virtual PObject * Clone() const;
  209.     virtual void PrintOn(ostream & strm) const;
  211.     virtual PString GetTypeAsString() const;
  212.     virtual PINDEX GetDataLength() const;
  213.     virtual BOOL Decode(PASN_Stream &);
  214.     virtual void Encode(PASN_Stream &) const;
  215. };
  218. /** Class for ASN Boolean type.
  219. */
  220. class PASN_Boolean : public PASN_Object
  221. {
  222.     PCLASSINFO(PASN_Boolean, PASN_Object);
  223.   public:
  224.     PASN_Boolean(BOOL val = FALSE,
  225.                  unsigned tag = UniversalBoolean,
  226.                  TagClass tagClass = UniversalTagClass);
  228.     PASN_Boolean & operator=(BOOL v) { value = v; return *this; }
  229.     operator BOOL() const { return value; }
  230.     BOOL GetValue() const { return value; }
  231.     void SetValue(BOOL v) { value = v; }
  233.     virtual Comparison Compare(const PObject & obj) const;
  234.     virtual PObject * Clone() const;
  235.     virtual void PrintOn(ostream & strm) const;
  237.     virtual PString GetTypeAsString() const;
  238.     virtual PINDEX GetDataLength() const;
  239.     virtual BOOL Decode(PASN_Stream &);
  240.     virtual void Encode(PASN_Stream &) const;
  242.   protected:
  243.     BOOL value;
  244. };
  247. /** Class for ASN Integer type.
  248. */
  249. class PASN_Integer : public PASN_ConstrainedObject
  250. {
  251.     PCLASSINFO(PASN_Integer, PASN_ConstrainedObject);
  252.   public:
  253.     PASN_Integer(unsigned tag = UniversalInteger,
  254.                  TagClass tagClass = UniversalTagClass,
  255.                  unsigned val = 0);
  257.     PASN_Integer & operator=(unsigned value);
  258.     operator unsigned() const { return value; }
  259.     unsigned GetValue() const { return value; }
  260.     void SetValue(unsigned v) { operator=(v); }
  262.     virtual Comparison Compare(const PObject & obj) const;
  263.     virtual PObject * Clone() const;
  264.     virtual void PrintOn(ostream & strm) const;
  266.     virtual PString GetTypeAsString() const;
  267.     virtual PINDEX GetDataLength() const;
  268.     virtual BOOL Decode(PASN_Stream &);
  269.     virtual void Encode(PASN_Stream &) const;
  271.     BOOL DecodePER(PPER_Stream & strm);
  272.     void EncodePER(PPER_Stream & strm) const;
  274.   protected:
  275.     unsigned value;
  276. };
  279. /** Class for ASN Enumerated type.
  280. */
  281. class PASN_Enumeration : public PASN_Object
  282. {
  283.     PCLASSINFO(PASN_Enumeration, PASN_Object);
  284.   public:
  285.     PASN_Enumeration(unsigned tag = UniversalEnumeration,
  286.                      TagClass tagClass = UniversalTagClass,
  287.                      unsigned nEnums = P_MAX_INDEX,
  288.                      BOOL extendable = FALSE,
  289.                      unsigned val = 0);
  290.     PASN_Enumeration(unsigned tag,
  291.                      TagClass tagClass,
  292.                      unsigned nEnums,
  293.                      BOOL extendable,
  294.                      const PString & nameSpec,
  295.                      unsigned val = 0);
  297.     PASN_Enumeration & operator=(unsigned v) { value = v; return *this; }
  298.     operator unsigned() const { return value; }
  299.     unsigned GetValue() const { return value; }
  300.     void SetValue(unsigned v) { value = v; }
  302.     unsigned GetMaximum() const { return maxEnumValue; }
  304.     virtual Comparison Compare(const PObject & obj) const;
  305.     virtual PObject * Clone() const;
  306.     virtual void PrintOn(ostream & strm) const;
  308.     virtual PString GetTypeAsString() const;
  309.     virtual PINDEX GetDataLength() const;
  310.     virtual BOOL Decode(PASN_Stream &);
  311.     virtual void Encode(PASN_Stream &) const;
  313.     BOOL DecodePER(PPER_Stream & strm);
  314.     void EncodePER(PPER_Stream & strm) const;
  316.   protected:
  317.     unsigned maxEnumValue;
  318.     unsigned value;
  319.     POrdinalToString names;
  320. };
  323. /** Class for ASN floating point type.
  324. */
  325. class PASN_Real : public PASN_Object
  326. {
  327.     PCLASSINFO(PASN_Real, PASN_Object);
  328.   public:
  329.     PASN_Real(unsigned tag = UniversalEnumeration,
  330.               TagClass tagClass = UniversalTagClass,
  331.               double val = 0);
  333.     PASN_Real & operator=(double val) { value = val; return *this; }
  334.     operator double() const { return value; }
  335.     double GetValue() const { return value; }
  336.     void SetValue(double v) { value = v; }
  338.     virtual Comparison Compare(const PObject & obj) const;
  339.     virtual PObject * Clone() const;
  340.     virtual void PrintOn(ostream & strm) const;
  342.     virtual PString GetTypeAsString() const;
  343.     virtual PINDEX GetDataLength() const;
  344.     virtual BOOL Decode(PASN_Stream &);
  345.     virtual void Encode(PASN_Stream &) const;
  347.   protected:
  348.     double value;
  349. };
  352. /** Class for ASN Object Identifier type.
  353. */
  354. class PASN_ObjectId : public PASN_Object
  355. {
  356.     PCLASSINFO(PASN_ObjectId, PASN_Object);
  357.   public:
  358.     PASN_ObjectId(unsigned tag = UniversalObjectId,
  359.                   TagClass tagClass = UniversalTagClass);
  361.     PASN_ObjectId(const PASN_ObjectId & other);
  362.     PASN_ObjectId & operator=(const PASN_ObjectId & other);
  364.     PASN_ObjectId & operator=(const char * dotstr);
  365.     PASN_ObjectId & operator=(const PString & dotstr);
  366.     void SetValue(const PString & dotstr);
  368.     BOOL operator==(const char * dotstr) const;
  369.     BOOL operator!=(const char * dotstr) const { return !operator==(dotstr); }
  370.     BOOL operator==(const PASN_ObjectId & id) const { return value == id.value; }
  372.     PINDEX GetSize() const { return value.GetSize(); }
  373.     const PUnsignedArray & GetValue() const { return value; }
  374.     unsigned operator[](PINDEX idx) const { return value[idx]; }
  376.     virtual Comparison Compare(const PObject & obj) const;
  377.     virtual PObject * Clone() const;
  378.     virtual void PrintOn(ostream & strm) const;
  380.     virtual PString GetTypeAsString() const;
  381.     virtual PINDEX GetDataLength() const;
  382.     virtual BOOL Decode(PASN_Stream &);
  383.     virtual void Encode(PASN_Stream &) const;
  385.     BOOL CommonDecode(PASN_Stream & strm, unsigned dataLen);
  386.     void CommonEncode(PBYTEArray & eObjId) const;
  388.   protected:
  389.     PUnsignedArray value;
  390. };
  393. /** Class for ASN Bit String type.
  394. */
  395. class PASN_BitString : public PASN_ConstrainedObject
  396. {
  397.     PCLASSINFO(PASN_BitString, PASN_ConstrainedObject);
  398.   public:
  399.     PASN_BitString(unsigned tag = UniversalBitString,
  400.                    TagClass tagClass = UniversalTagClass,
  401.                    unsigned nBits = 0);
  403.     PASN_BitString(const PASN_BitString & other);
  404.     PASN_BitString & operator=(const PASN_BitString & other);
  406.     void SetData(unsigned nBits, const PBYTEArray & bytes);
  407.     void SetData(unsigned nBits, const BYTE * buf, PINDEX size);
  409.     unsigned GetSize() const { return totalBits; }
  410.     BOOL SetSize(unsigned nBits);
  412.     BOOL operator[](PINDEX bit) const;
  413.     void Set(unsigned bit);
  414.     void Clear(unsigned bit);
  415.     void Invert(unsigned bit);
  417.     virtual void SetConstraints(ConstraintType type, int lower = 0, unsigned upper = UINT_MAX);
  419.     virtual Comparison Compare(const PObject & obj) const;
  420.     virtual PObject * Clone() const;
  421.     virtual void PrintOn(ostream & strm) const;
  423.     virtual PString GetTypeAsString() const;
  424.     virtual PINDEX GetDataLength() const;
  425.     virtual BOOL Decode(PASN_Stream &);
  426.     virtual void Encode(PASN_Stream &) const;
  428.     BOOL DecodeBER(PBER_Stream & strm, unsigned len);
  429.     void EncodeBER(PBER_Stream & strm) const;
  430.     BOOL DecodePER(PPER_Stream & strm);
  431.     void EncodePER(PPER_Stream & strm) const;
  433.   protected:
  434.     unsigned totalBits;
  435.     PBYTEArray bitData;
  436. };
  439. /** Class for ASN Octet String type.
  440. */
  441. class PASN_OctetString : public PASN_ConstrainedObject
  442. {
  443.     PCLASSINFO(PASN_OctetString, PASN_ConstrainedObject);
  444.   public:
  445.     PASN_OctetString(unsigned tag = UniversalOctetString,
  446.                      TagClass tagClass = UniversalTagClass);
  448.     PASN_OctetString(const PASN_OctetString & other);
  449.     PASN_OctetString & operator=(const PASN_OctetString & other);
  451.     PASN_OctetString & operator=(const char * str);
  452.     PASN_OctetString & operator=(const PString & str);
  453.     PASN_OctetString & operator=(const PBYTEArray & arr);
  454.     void SetValue(const char * str) { operator=(str); }
  455.     void SetValue(const PString & str) { operator=(str); }
  456.     void SetValue(const PBYTEArray & arr) { operator=(arr); }
  457.     void SetValue(const BYTE * data, PINDEX len);
  458.     const PBYTEArray & GetValue() const { return value; }
  459.     operator const PBYTEArray &() const { return value; }
  460.     operator const BYTE *() const { return value; }
  461.     PString AsString() const;
  462.     BYTE operator[](PINDEX i) const { return value[i]; }
  463.     BYTE & operator[](PINDEX i) { return value[i]; }
  464.     BYTE * GetPointer(PINDEX sz = 0) { return value.GetPointer(sz); }
  465.     PINDEX GetSize() const { return value.GetSize(); }
  466.     BOOL SetSize(PINDEX newSize) { return value.SetSize(newSize); }
  468.     virtual void SetConstraints(ConstraintType type, int lower = 0, unsigned upper = UINT_MAX);
  470.     virtual Comparison Compare(const PObject & obj) const;
  471.     virtual PObject * Clone() const;
  472.     virtual void PrintOn(ostream & strm) const;
  474.     virtual PString GetTypeAsString() const;
  475.     virtual PINDEX GetDataLength() const;
  476.     virtual BOOL Decode(PASN_Stream &);
  477.     virtual void Encode(PASN_Stream &) const;
  479.     BOOL DecodePER(PPER_Stream & strm);
  480.     void EncodePER(PPER_Stream & strm) const;
  482.   protected:
  483.     PBYTEArray value;
  484. };
  487. /** Base class for ASN String types.
  488. */
  489. class PASN_ConstrainedString : public PASN_ConstrainedObject
  490. {
  491.     PCLASSINFO(PASN_ConstrainedString, PASN_ConstrainedObject);
  492.   public:
  493.     PASN_ConstrainedString & operator=(const char * str);
  494.     PASN_ConstrainedString & operator=(const PString & str) { return operator=((const char *)str); }
  495.     operator const PString &() const { return value; }
  496.     const PString & GetValue() const { return value; }
  497.     void SetValue(const PString & v) { operator=(v); }
  498.     char operator[](PINDEX idx) const { return value[idx]; }
  500.     void SetCharacterSet(ConstraintType ctype, const char * charSet);
  501.     void SetCharacterSet(ConstraintType ctype, unsigned firstChar = 0, unsigned lastChar = 255);
  502.     void SetCharacterSet(const char * charSet, PINDEX size, ConstraintType ctype);
  504.     virtual Comparison Compare(const PObject & obj) const;
  505.     virtual void PrintOn(ostream & strm) const;
  507.     virtual PINDEX GetDataLength() const;
  508.     virtual BOOL Decode(PASN_Stream &);
  509.     virtual void Encode(PASN_Stream &) const;
  511.     BOOL DecodeBER(PBER_Stream & strm, unsigned len);
  512.     void EncodeBER(PBER_Stream & strm) const;
  513.     BOOL DecodePER(PPER_Stream & strm);
  514.     void EncodePER(PPER_Stream & strm) const;
  516.   protected:
  517.     PASN_ConstrainedString(const char * canonicalSet, PINDEX setSize,
  518.                            unsigned tag, TagClass tagClass);
  520.     PString value;
  521.     PCharArray characterSet;
  522.     const char * canonicalSet;
  523.     PINDEX canonicalSetSize;
  524.     unsigned canonicalSetBits;
  525.     unsigned charSetUnalignedBits;
  526.     unsigned charSetAlignedBits;
  527. };
  530. #define DECLARE_STRING_CLASS(name) 
  531.   class PASN_##name##String : public PASN_ConstrainedString { 
  532.     PCLASSINFO(PASN_##name##String, PASN_ConstrainedString); 
  533.     public: 
  534.       PASN_##name##String(unsigned tag = UniversalNumericString, 
  535.                           TagClass tagClass = UniversalTagClass); 
  536.       PASN_##name##String & operator=(const char * str); 
  537.       PASN_##name##String & operator=(const PString & str); 
  538.       virtual PObject * Clone() const; 
  539.       virtual PString GetTypeAsString() const; 
  540.   }
  542. DECLARE_STRING_CLASS(Numeric);
  543. DECLARE_STRING_CLASS(Printable);
  544. DECLARE_STRING_CLASS(Visible);
  545. DECLARE_STRING_CLASS(IA5);
  546. DECLARE_STRING_CLASS(General);
  549. /** Class for ASN BMP (16 bit) String type.
  550. */
  551. class PASN_BMPString : public PASN_ConstrainedObject
  552. {
  553.     PCLASSINFO(PASN_BMPString, PASN_ConstrainedObject);
  554.   public:
  555.     PASN_BMPString(unsigned tag = UniversalBMPString,
  556.                    TagClass tagClass = UniversalTagClass);
  558.     PASN_BMPString(const PASN_BMPString & other);
  559.     PASN_BMPString & operator=(const PASN_BMPString & other);
  561.     PASN_BMPString & operator=(const PString & v);
  562.     PASN_BMPString & operator=(const PWORDArray & v);
  563.     operator PString() const { return GetValue(); }
  564.     operator PWORDArray() const { return value; }
  565.     PString GetValue() const;
  566.     void GetValue(PWORDArray & v) const { v = value; }
  567.     void SetValue(const PString & v) { operator=(v); }
  568.     void SetValue(const PWORDArray & v) { operator=(v); }
  570.     void SetCharacterSet(ConstraintType ctype, const char * charSet);
  571.     void SetCharacterSet(ConstraintType ctype, const PWORDArray & charSet);
  572.     void SetCharacterSet(ConstraintType ctype, unsigned firstChar, unsigned lastChar);
  574.     virtual Comparison Compare(const PObject & obj) const;
  575.     virtual PObject * Clone() const;
  576.     virtual void PrintOn(ostream & strm) const;
  578.     virtual PString GetTypeAsString() const;
  579.     virtual PINDEX GetDataLength() const;
  580.     virtual BOOL Decode(PASN_Stream &);
  581.     virtual void Encode(PASN_Stream &) const;
  583.     BOOL DecodeBER(PBER_Stream & strm, unsigned len);
  584.     void EncodeBER(PBER_Stream & strm) const;
  585.     BOOL DecodePER(PPER_Stream & strm);
  586.     void EncodePER(PPER_Stream & strm) const;
  588.   protected:
  589.     BOOL IsLegalCharacter(WORD ch);
  591.     PWORDArray value;
  592.     PWORDArray characterSet;
  593.     WORD firstChar, lastChar;
  594.     unsigned charSetUnalignedBits;
  595.     unsigned charSetAlignedBits;
  596. };
  599. class PASN_Sequence;
  601. /** Class for ASN Choice type.
  602. */
  603. class PASN_Choice : public PASN_Object
  604. {
  605.     PCLASSINFO(PASN_Choice, PASN_Object);
  606.   public:
  607.     ~PASN_Choice();
  609.     virtual void SetTag(unsigned newTag, TagClass tagClass = DefaultTagClass);
  610.     PString GetTagName() const;
  611.     PASN_Object & GetObject() const;
  612.     BOOL IsValid() const { return choice != NULL; }
  614. #if defined(__GNUC__) && __GNUC__ <= 2 && __GNUC_MINOR__ < 9
  616.     operator PASN_Null &() const;
  617.     operator PASN_Boolean &() const;
  618.     operator PASN_Integer &() const;
  619.     operator PASN_Enumeration &() const;
  620.     operator PASN_Real &() const;
  621.     operator PASN_ObjectId &() const;
  622.     operator PASN_BitString &() const;
  623.     operator PASN_OctetString &() const;
  624.     operator PASN_NumericString &() const;
  625.     operator PASN_PrintableString &() const;
  626.     operator PASN_VisibleString &() const;
  627.     operator PASN_IA5String &() const;
  628.     operator PASN_GeneralString &() const;
  629.     operator PASN_BMPString &() const;
  630.     operator PASN_Sequence &() const;
  632. #else
  634.     operator PASN_Null &();
  635.     operator PASN_Boolean &();
  636.     operator PASN_Integer &();
  637.     operator PASN_Enumeration &();
  638.     operator PASN_Real &();
  639.     operator PASN_ObjectId &();
  640.     operator PASN_BitString &();
  641.     operator PASN_OctetString &();
  642.     operator PASN_NumericString &();
  643.     operator PASN_PrintableString &();
  644.     operator PASN_VisibleString &();
  645.     operator PASN_IA5String &();
  646.     operator PASN_GeneralString &();
  647.     operator PASN_BMPString &();
  648.     operator PASN_Sequence &();
  650.     operator const PASN_Null &() const;
  651.     operator const PASN_Boolean &() const;
  652.     operator const PASN_Integer &() const;
  653.     operator const PASN_Enumeration &() const;
  654.     operator const PASN_Real &() const;
  655.     operator const PASN_ObjectId &() const;
  656.     operator const PASN_BitString &() const;
  657.     operator const PASN_OctetString &() const;
  658.     operator const PASN_NumericString &() const;
  659.     operator const PASN_PrintableString &() const;
  660.     operator const PASN_VisibleString &() const;
  661.     operator const PASN_IA5String &() const;
  662.     operator const PASN_GeneralString &() const;
  663.     operator const PASN_BMPString &() const;
  664.     operator const PASN_Sequence &() const;
  666. #endif
  668.     virtual BOOL CreateObject() = 0;
  670.     virtual Comparison Compare(const PObject & obj) const;
  671.     virtual void PrintOn(ostream & strm) const;
  673.     virtual PString GetTypeAsString() const;
  674.     virtual PINDEX GetDataLength() const;
  675.     virtual BOOL IsPrimitive() const;
  676.     virtual BOOL Decode(PASN_Stream &);
  677.     virtual void Encode(PASN_Stream &) const;
  679.     virtual BOOL DecodePER(PPER_Stream &);
  680.     virtual void EncodePER(PPER_Stream &) const;
  682.   protected:
  683.     PASN_Choice(unsigned nChoices = UINT_MAX, BOOL extend = FALSE);
  684.     PASN_Choice(unsigned tag, TagClass tagClass, unsigned nChoices, BOOL extend);
  685.     PASN_Choice(unsigned tag, TagClass tagClass, unsigned nChoices, BOOL extend, const PString & nameSpec);
  687.     PASN_Choice(const PASN_Choice & other);
  688.     PASN_Choice & operator=(const PASN_Choice & other);
  690.     unsigned numChoices;
  691.     PASN_Object * choice;
  692.     POrdinalToString names;
  693. };
  696. PARRAY(PASN_ObjectArray, PASN_Object);
  699. /** Class for ASN Sequence type.
  700. */
  701. class PASN_Sequence : public PASN_Object
  702. {
  703.     PCLASSINFO(PASN_Sequence, PASN_Object);
  704.   public:
  705.     PASN_Sequence(unsigned tag = UniversalSequence,
  706.                   TagClass tagClass = UniversalTagClass,
  707.                   unsigned nOpts = 0, BOOL extend = FALSE, unsigned nExtend = 0);
  709.     PASN_Sequence(const PASN_Sequence & other);
  710.     PASN_Sequence & operator=(const PASN_Sequence & other);
  712.     PINDEX GetSize() const { return fields.GetSize(); }
  713.     void SetSize(PINDEX newSize);
  714.     PASN_Object & operator[](PINDEX i) const { return fields[i]; }
  716.     BOOL HasOptionalField(PINDEX opt) const;
  717.     void IncludeOptionalField(PINDEX opt);
  718.     void RemoveOptionalField(PINDEX opt);
  720.     virtual Comparison Compare(const PObject & obj) const;
  721.     virtual PObject * Clone() const;
  722.     virtual void PrintOn(ostream & strm) const;
  724.     virtual PString GetTypeAsString() const;
  725.     virtual PINDEX GetDataLength() const;
  726.     virtual BOOL IsPrimitive() const;
  727.     virtual BOOL Decode(PASN_Stream &);
  728.     virtual void Encode(PASN_Stream &) const;
  730.     BOOL PreambleDecode(PASN_Stream & strm);
  731.     void PreambleEncode(PASN_Stream & strm) const;
  732.     BOOL KnownExtensionDecode(PASN_Stream & strm, PINDEX fld, PASN_Object & field);
  733.     void KnownExtensionEncode(PASN_Stream & strm, PINDEX fld, const PASN_Object & field) const;
  734.     BOOL UnknownExtensionsDecode(PASN_Stream & strm);
  735.     void UnknownExtensionsEncode(PASN_Stream & strm) const;
  737.     BOOL PreambleDecodeBER(PBER_Stream & strm);
  738.     void PreambleEncodeBER(PBER_Stream & strm) const;
  739.     BOOL KnownExtensionDecodeBER(PBER_Stream & strm, PINDEX fld, PASN_Object & field);
  740.     void KnownExtensionEncodeBER(PBER_Stream & strm, PINDEX fld, const PASN_Object & field) const;
  741.     BOOL UnknownExtensionsDecodeBER(PBER_Stream & strm);
  742.     void UnknownExtensionsEncodeBER(PBER_Stream & strm) const;
  744.     BOOL PreambleDecodePER(PPER_Stream & strm);
  745.     void PreambleEncodePER(PPER_Stream & strm) const;
  746.     BOOL KnownExtensionDecodePER(PPER_Stream & strm, PINDEX fld, PASN_Object & field);
  747.     void KnownExtensionEncodePER(PPER_Stream & strm, PINDEX fld, const PASN_Object & field) const;
  748.     BOOL UnknownExtensionsDecodePER(PPER_Stream & strm);
  749.     void UnknownExtensionsEncodePER(PPER_Stream & strm) const;
  751.   protected:
  752.     BOOL NoExtensionsToDecode(PPER_Stream & strm);
  753.     BOOL NoExtensionsToEncode(PPER_Stream & strm);
  755.     PASN_ObjectArray fields;
  756.     PASN_BitString optionMap;
  757.     int knownExtensions;
  758.     int totalExtensions;
  759.     PASN_BitString extensionMap;
  760.     PINDEX endBasicEncoding;
  761. };
  764. /** Class for ASN Set type.
  765. */
  766. class PASN_Set : public PASN_Sequence
  767. {
  768.     PCLASSINFO(PASN_Set, PASN_Sequence);
  769.   public:
  770.     PASN_Set(unsigned tag = UniversalSet,
  771.              TagClass tagClass = UniversalTagClass,
  772.              unsigned nOpts = 0, BOOL extend = FALSE, unsigned nExtend = 0);
  774.     virtual PObject * Clone() const;
  775.     virtual PString GetTypeAsString() const;
  776. };
  779. /** Class for ASN Array type.
  780. */
  781. class PASN_Array : public PASN_ConstrainedObject
  782. {
  783.     PCLASSINFO(PASN_Array, PASN_ConstrainedObject);
  784.   public:
  785.     PINDEX GetSize() const { return array.GetSize(); }
  786.     void SetSize(PINDEX newSize);
  787.     PASN_Object & operator[](PINDEX i) const { return array[i]; }
  788.     void RemoveAt(PINDEX i) { array.RemoveAt(i); }
  789.     void RemoveAll() { array.RemoveAll(); }
  791.     virtual Comparison Compare(const PObject & obj) const;
  792.     virtual void PrintOn(ostream & strm) const;
  794.     virtual PString GetTypeAsString() const;
  795.     virtual PINDEX GetDataLength() const;
  796.     virtual BOOL IsPrimitive() const;
  797.     virtual BOOL Decode(PASN_Stream &);
  798.     virtual void Encode(PASN_Stream &) const;
  800.     virtual PASN_Object * CreateObject() const = 0;
  802.   protected:
  803.     PASN_Array(unsigned tag = UniversalSequence,
  804.                TagClass tagClass = UniversalTagClass);
  806.     PASN_Array(const PASN_Array & other);
  807.     PASN_Array & operator=(const PASN_Array & other);
  809.     PASN_ObjectArray array;
  810. };
  813. /////////////////////////////////////////////////////////////////////////////
  815. /** Base class for ASN decoder/encoder stream.
  816. */
  817. class PASN_Stream : public PBYTEArray
  818. {
  819.     PCLASSINFO(PASN_Stream, PBYTEArray);
  820.   public:
  821.     PASN_Stream();
  822.     PASN_Stream(const PBYTEArray & bytes);
  823.     PASN_Stream(const BYTE * buf, PINDEX size);
  825.     void PrintOn(ostream & strm) const;
  827.     PINDEX GetPosition() const { return byteOffset; }
  828.     void SetPosition(PINDEX newPos);
  829.     BOOL IsAtEnd() { return byteOffset >= GetSize(); }
  830.     void ResetDecoder();
  831.     void BeginEncoding();
  832.     void CompleteEncoding();
  834.     virtual BOOL Read(PChannel & chan) = 0;
  835.     virtual BOOL Write(PChannel & chan) = 0;
  837.     virtual BOOL NullDecode(PASN_Null &) = 0;
  838.     virtual void NullEncode(const PASN_Null &) = 0;
  839.     virtual BOOL BooleanDecode(PASN_Boolean &) = 0;
  840.     virtual void BooleanEncode(const PASN_Boolean &) = 0;
  841.     virtual BOOL IntegerDecode(PASN_Integer &) = 0;
  842.     virtual void IntegerEncode(const PASN_Integer &) = 0;
  843.     virtual BOOL EnumerationDecode(PASN_Enumeration &) = 0;
  844.     virtual void EnumerationEncode(const PASN_Enumeration &) = 0;
  845.     virtual BOOL RealDecode(PASN_Real &) = 0;
  846.     virtual void RealEncode(const PASN_Real &) = 0;
  847.     virtual BOOL ObjectIdDecode(PASN_ObjectId &) = 0;
  848.     virtual void ObjectIdEncode(const PASN_ObjectId &) = 0;
  849.     virtual BOOL BitStringDecode(PASN_BitString &) = 0;
  850.     virtual void BitStringEncode(const PASN_BitString &) = 0;
  851.     virtual BOOL OctetStringDecode(PASN_OctetString &) = 0;
  852.     virtual void OctetStringEncode(const PASN_OctetString &) = 0;
  853.     virtual BOOL ConstrainedStringDecode(PASN_ConstrainedString &) = 0;
  854.     virtual void ConstrainedStringEncode(const PASN_ConstrainedString &) = 0;
  855.     virtual BOOL BMPStringDecode(PASN_BMPString &) = 0;
  856.     virtual void BMPStringEncode(const PASN_BMPString &) = 0;
  857.     virtual BOOL ChoiceDecode(PASN_Choice &) = 0;
  858.     virtual void ChoiceEncode(const PASN_Choice &) = 0;
  859.     virtual BOOL ArrayDecode(PASN_Array &) = 0;
  860.     virtual void ArrayEncode(const PASN_Array &) = 0;
  861.     virtual BOOL SequencePreambleDecode(PASN_Sequence &) = 0;
  862.     virtual void SequencePreambleEncode(const PASN_Sequence &) = 0;
  863.     virtual BOOL SequenceKnownDecode(PASN_Sequence &, PINDEX, PASN_Object &) = 0;
  864.     virtual void SequenceKnownEncode(const PASN_Sequence &, PINDEX, const PASN_Object &) = 0;
  865.     virtual BOOL SequenceUnknownDecode(PASN_Sequence &) = 0;
  866.     virtual void SequenceUnknownEncode(const PASN_Sequence &) = 0;
  868.     BYTE ByteDecode();
  869.     void ByteEncode(unsigned value);
  871.     unsigned BlockDecode(BYTE * bufptr, unsigned nBytes);
  872.     void BlockEncode(const BYTE * bufptr, PINDEX nBytes);
  874.     void ByteAlign();
  876.   protected:
  877.     PINDEX byteOffset;
  878.     unsigned bitOffset;
  880.   private:
  881.     void Construct();
  882. };
  885. /** Class for ASN basic Encoding Rules stream.
  886. */
  887. class PBER_Stream : public PASN_Stream
  888. {
  889.     PCLASSINFO(PBER_Stream, PASN_Stream);
  890.   public:
  891.     PBER_Stream();
  892.     PBER_Stream(const PBYTEArray & bytes);
  893.     PBER_Stream(const BYTE * buf, PINDEX size);
  895.     PBER_Stream & operator=(const PBYTEArray & bytes);
  897.     virtual BOOL Read(PChannel & chan);
  898.     virtual BOOL Write(PChannel & chan);
  900.     virtual BOOL NullDecode(PASN_Null &);
  901.     virtual void NullEncode(const PASN_Null &);
  902.     virtual BOOL BooleanDecode(PASN_Boolean &);
  903.     virtual void BooleanEncode(const PASN_Boolean &);
  904.     virtual BOOL IntegerDecode(PASN_Integer &);
  905.     virtual void IntegerEncode(const PASN_Integer &);
  906.     virtual BOOL EnumerationDecode(PASN_Enumeration &);
  907.     virtual void EnumerationEncode(const PASN_Enumeration &);
  908.     virtual BOOL RealDecode(PASN_Real &);
  909.     virtual void RealEncode(const PASN_Real &);
  910.     virtual BOOL ObjectIdDecode(PASN_ObjectId &);
  911.     virtual void ObjectIdEncode(const PASN_ObjectId &);
  912.     virtual BOOL BitStringDecode(PASN_BitString &);
  913.     virtual void BitStringEncode(const PASN_BitString &);
  914.     virtual BOOL OctetStringDecode(PASN_OctetString &);
  915.     virtual void OctetStringEncode(const PASN_OctetString &);
  916.     virtual BOOL ConstrainedStringDecode(PASN_ConstrainedString &);
  917.     virtual void ConstrainedStringEncode(const PASN_ConstrainedString &);
  918.     virtual BOOL BMPStringDecode(PASN_BMPString &);
  919.     virtual void BMPStringEncode(const PASN_BMPString &);
  920.     virtual BOOL ChoiceDecode(PASN_Choice &);
  921.     virtual void ChoiceEncode(const PASN_Choice &);
  922.     virtual BOOL ArrayDecode(PASN_Array &);
  923.     virtual void ArrayEncode(const PASN_Array &);
  924.     virtual BOOL SequencePreambleDecode(PASN_Sequence &);
  925.     virtual void SequencePreambleEncode(const PASN_Sequence &);
  926.     virtual BOOL SequenceKnownDecode(PASN_Sequence &, PINDEX, PASN_Object &);
  927.     virtual void SequenceKnownEncode(const PASN_Sequence &, PINDEX, const PASN_Object &);
  928.     virtual BOOL SequenceUnknownDecode(PASN_Sequence &);
  929.     virtual void SequenceUnknownEncode(const PASN_Sequence &);
  931.     virtual PASN_Object * CreateObject(unsigned tag,
  932.                                        PASN_Object::TagClass tagClass,
  933.                                        BOOL primitive) const;
  935.     BOOL HeaderDecode(unsigned & tagVal,
  936.                       PASN_Object::TagClass & tagClass,
  937.                       BOOL & primitive,
  938.                       unsigned & len);
  939.     BOOL HeaderDecode(PASN_Object & obj, unsigned & len);
  940.     void HeaderEncode(const PASN_Object & obj);
  941. };
  944. /** Class for ASN Packed Encoding Rules stream.
  945. */
  946. class PPER_Stream : public PASN_Stream
  947. {
  948.     PCLASSINFO(PPER_Stream, PASN_Stream);
  949.   public:
  950.     PPER_Stream(BOOL aligned = TRUE);
  951.     PPER_Stream(const PBYTEArray & bytes, BOOL aligned = TRUE);
  952.     PPER_Stream(const BYTE * buf, PINDEX size, BOOL aligned = TRUE);
  954.     PPER_Stream & operator=(const PBYTEArray & bytes);
  956.     unsigned GetBitsLeft() const;
  958.     virtual BOOL Read(PChannel & chan);
  959.     virtual BOOL Write(PChannel & chan);
  961.     virtual BOOL NullDecode(PASN_Null &);
  962.     virtual void NullEncode(const PASN_Null &);
  963.     virtual BOOL BooleanDecode(PASN_Boolean &);
  964.     virtual void BooleanEncode(const PASN_Boolean &);
  965.     virtual BOOL IntegerDecode(PASN_Integer &);
  966.     virtual void IntegerEncode(const PASN_Integer &);
  967.     virtual BOOL EnumerationDecode(PASN_Enumeration &);
  968.     virtual void EnumerationEncode(const PASN_Enumeration &);
  969.     virtual BOOL RealDecode(PASN_Real &);
  970.     virtual void RealEncode(const PASN_Real &);
  971.     virtual BOOL ObjectIdDecode(PASN_ObjectId &);
  972.     virtual void ObjectIdEncode(const PASN_ObjectId &);
  973.     virtual BOOL BitStringDecode(PASN_BitString &);
  974.     virtual void BitStringEncode(const PASN_BitString &);
  975.     virtual BOOL OctetStringDecode(PASN_OctetString &);
  976.     virtual void OctetStringEncode(const PASN_OctetString &);
  977.     virtual BOOL ConstrainedStringDecode(PASN_ConstrainedString &);
  978.     virtual void ConstrainedStringEncode(const PASN_ConstrainedString &);
  979.     virtual BOOL BMPStringDecode(PASN_BMPString &);
  980.     virtual void BMPStringEncode(const PASN_BMPString &);
  981.     virtual BOOL ChoiceDecode(PASN_Choice &);
  982.     virtual void ChoiceEncode(const PASN_Choice &);
  983.     virtual BOOL ArrayDecode(PASN_Array &);
  984.     virtual void ArrayEncode(const PASN_Array &);
  985.     virtual BOOL SequencePreambleDecode(PASN_Sequence &);
  986.     virtual void SequencePreambleEncode(const PASN_Sequence &);
  987.     virtual BOOL SequenceKnownDecode(PASN_Sequence &, PINDEX, PASN_Object &);
  988.     virtual void SequenceKnownEncode(const PASN_Sequence &, PINDEX, const PASN_Object &);
  989.     virtual BOOL SequenceUnknownDecode(PASN_Sequence &);
  990.     virtual void SequenceUnknownEncode(const PASN_Sequence &);
  992.     BOOL IsAligned() const { return aligned; }
  994.     BOOL SingleBitDecode();
  995.     void SingleBitEncode(BOOL value);
  997.     int MultiBitDecode(unsigned nBits);
  998.     void MultiBitEncode(int value, unsigned nBits);
  1000.     unsigned SmallUnsignedDecode();
  1001.     void SmallUnsignedEncode(unsigned val);
  1003.     int LengthDecode(unsigned lower, unsigned upper, unsigned & len);
  1004.     void LengthEncode(unsigned len, unsigned lower, unsigned upper);
  1006.     int UnsignedDecode(unsigned lower, unsigned upper, unsigned & value);
  1007.     void UnsignedEncode(int value, unsigned lower, unsigned upper);
  1009.     void AnyTypeEncode(const PASN_Object * value);
  1011.   protected:
  1012.     BOOL aligned;
  1013. };
  1016. #endif // _ASNER_H