summaryrefslogtreecommitdiff
path: root/ACEXML/common/StreamFactory.h
blob: 9391eb6a299081651793a86baa79f37fb41e6962 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
/**
 *  @file StreamFactory.h
 *
 *  $Id$
 *
 *  @author Krishnakumar B <kitty@cs.wustl.edu>
 */

#ifndef _ACEXML_STREAM_FACTORY_H
#define _ACEXML_STREAM_FACTORY_H

#include /**/ "ace/pre.h"
#include "ACEXML/common/ACEXML_Export.h"

#if !defined (ACE_LACKS_PRAGMA_ONCE)
#pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */

#include "ACEXML/common/XML_Types.h"

// Forward declarations

class ACEXML_CharStream;

/**
 *  @class ACEXML_StreamFactory StreamFactory.h "ACEXML/common/ACEXML_StreamFactory.h"
 *
 *  @brief A generic factory used to create an appropriate @sa
 *  ACEXML_CharStream from a SYSTEM id. This class creates a @sa
 *  ACEXML_FileCharStream or a @sa ACEXML_HttpCharStream depending on the
 *  URI supplied.
 *
 *  @todo Write a stream abstraction for handling ftp:// type URIs and add
 *  a function to create and return such streams. That is the only chunk
 *  missing in the armour.
 */

class ACEXML_Export ACEXML_StreamFactory
{
public:

  // Destructor
  virtual ~ACEXML_StreamFactory (void);

  /**
   *  Create the appropriate stream from the @a uri passed and return the
   *  stream. The caller is responsible for deallocating the returned
   *  stream.
   *
   *  @param uri SYSTEM id or a stream of characters (in the case of a
   *  StrCharStream).
   */
  virtual ACEXML_CharStream* create_stream (const ACEXML_Char* uri);
};

#include /**/ "ace/post.h"

#endif /* _ACEXML_STREAM_FACTORY_H */