File: StreamFactory.h

package info (click to toggle)
ace 6.0.3%2Bdfsg-0.1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 49,368 kB
  • sloc: cpp: 341,826; perl: 30,850; ansic: 20,952; makefile: 10,144; sh: 4,744; python: 828; exp: 787; yacc: 511; xml: 330; lex: 158; lisp: 116; csh: 48; tcl: 5
file content (58 lines) | stat: -rw-r--r-- 1,472 bytes parent folder | download
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: StreamFactory.h 80826 2008-03-04 14:51:23Z wotte $
 *
 *  @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 */