Category

Development Platform
Home > SourceCode/Document > Database system > View Code
README
Package: postgresql-6.5.2.tar.gz　[view]
Upload User: blenddy
Upload Date: 2007-01-07
Package Size: 6495k
Code Size: 3k
Category:

Database system

Development Platform:

Unix_Linux

README：Code Content
  1. *******************************************************************************
  2. *                                                                             *
  3. * EXPLANATION OF THE NODE STRUCTURES                                          *
  4. *    - Andrew Yu (11/94)                                                      *
  5. *                                                                             *
  6. * Copyright (c) 1994, Regents of the University of California                 *
  7. *                                                                             *
  8. * $Id: README,v 1.1.1.1 1996/07/09 06:21:32 scrappy Exp $
  9. *                                                                             *
  10. *******************************************************************************
  12. INTRODUCTION
  14. The current node structures are plain old C structures. "Inheritance" is
  15. achieved by convention. No additional functions will be generated. Functions
  16. that manipulate node structures reside in this directory.
  19. FILES IN THIS DIRECTORY
  21.     Node manipulation functions:
  22. copyfuncs.c - copying a node
  23. equalfuncs.c - comparing a node
  24. outfuncs.c - convert a node to ascii representation
  25. readfuncs.c - convert ascii representation back to a node
  26. makefuncs.c - creator functions for primitive nodes
  28.     Node definitions:
  29. nodes.h - define node tags (NodeTag)
  30. pg_list.h - generic list 
  31. primnodes.h - primitive nodes
  32. parsenodes.h - parse tree nodes
  33. plannodes.h - plan tree nodes
  34. relation.h - inner plan tree nodes
  35. execnodes.h - executor nodes
  36. memnodes.h - memory nodes
  39. STEPS TO ADD A NODE
  41. Suppose you wana define a node Foo:
  43. 1. add a tag (T_Foo) to the enum NodeTag in nodes.h (You may have to
  44.    recompile the whole tree after doing this.)
  45. 2. add the structure definition to the appropriate ???nodes.h file. If you
  46.    intend to inherit from, say a Plan node, put Plan as the first field of
  47.    you definition.
  48. 3. if you intend to use copyObject, equal, nodeToString or stringToNode,
  49.    add an appropriate function to copyfuncs.c, equalfuncs.c, outfuncs.c
  50.    and readfuncs.c accordingly. (Except for frequently used nodes, don't
  51.    bother writing a creator function in makefuncs.c)
  54. HISTORICAL NOTE
  56. Prior to the current simple C structure definitions, the Node structures 
  57. uses a pseudo-inheritance system which automatically generates creator and
  58. accessor functions. Since every node inherits from LispValue, the whole thing
  59. is a mess. Here's a little anecdote:
  61.     LispValue definition -- class used to support lisp structures
  62.     in C.  This is here because we did not want to totally rewrite
  63.     planner and executor code which depended on lisp structures when
  64.     we ported postgres V1 from lisp to C. -cim 4/23/90
  65.