/[thuban]/branches/WIP-pyshapelib-bramz/Thuban/Model/save.py
ViewVC logotype

Diff of /branches/WIP-pyshapelib-bramz/Thuban/Model/save.py

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 268 by bh, Thu Aug 22 10:25:43 2002 UTC revision 773 by jonathan, Tue Apr 29 14:34:23 2003 UTC
# Line 1  Line 1 
1  # Copyright (c) 2001, 2002 by Intevation GmbH  # Copyright (c) 2001, 2002, 2003 by Intevation GmbH
2  # Authors:  # Authors:
3  # Jan-Oliver Wagner <[email protected]>  # Jan-Oliver Wagner <[email protected]>
4  # Bernhard Herzog <[email protected]>  # Bernhard Herzog <[email protected]>
5    # Jonathan Coles <[email protected]>
6  #  #
7  # This program is free software under the GPL (>=v2)  # This program is free software under the GPL (>=v2)
8  # Read the file COPYING coming with Thuban for details.  # Read the file COPYING coming with Thuban for details.
# Line 12  Functions to save a session to a file Line 13  Functions to save a session to a file
13    
14  __version__ = "$Revision$"  __version__ = "$Revision$"
15    
16    # fix for people using python2.1
17    from __future__ import nested_scopes
18    
19  import os  import os
20  import string  import string
21    
22  import Thuban.Lib.fileutil  import Thuban.Lib.fileutil
23    
24    from Thuban.Model.color import Color
25    
26    from Thuban.Model.classification import *
27    
28    #
29    # one level of indention
30    #
31    TAB = "    "
32    
33  def relative_filename(dir, filename):  def relative_filename(dir, filename):
34      """Return a filename relative to dir for the absolute file name absname.      """Return a filename relative to dir for the absolute file name absname.
35    
# Line 39  def escape(data): Line 52  def escape(data):
52      data = string.replace(data, "'", "&apos;")      data = string.replace(data, "'", "&apos;")
53      return data      return data
54    
55  class Saver:  class XMLWriter:
56        """Abstract XMLWriter.
     """Class to serialize a session into an XML file.  
57    
58      Applications built on top of Thuban may derive from this class and      Should be overridden to provide specific object saving functionality.
     override or extend the methods to save additinal information. This  
     additional information should take the form of additional attributes  
     or elements whose names are prefixed with a namespace. To define a  
     namespace derived classes should extend the write_session method to  
     pass the namespaces to the default implementation.  
59      """      """
60    
61      def __init__(self, session):      def __init__(self):
62          self.session = session          self.filename = None
63            pass
64    
65      def write(self, file_or_filename):      def write(self, file_or_filename):
66          """Write the session to a file.          """Write the session to a file.
# Line 65  class Saver: Line 73  class Saver:
73          directory.          directory.
74    
75          If the argument is a file object (which is determined by the          If the argument is a file object (which is determined by the
76          presence of a write method) all filenames will be absolut          presence of a write method) all filenames will be absolute
77          filenames.          filenames.
78          """          """
79    
80            # keep track of how many levels of indentation to write
81            self.indent_level = 0
82            # track whether an element is currently open. see open_element().
83            self.element_open = 0
84    
85          if hasattr(file_or_filename, "write"):          if hasattr(file_or_filename, "write"):
86              # it's a file object              # it's a file object
87              self.file = file_or_filename              self.file = file_or_filename
88              self.dir = ""              self.dir = ""
89          else:          else:
90              filename = file_or_filename              self.filename = file_or_filename
91              self.dir = os.path.dirname(filename)              self.dir = os.path.dirname(self.filename)
92              self.file = open(filename, 'w')              self.file = open(self.filename, 'w')
93          self.write_header()  
94          self.write_session(self.session)      def close(self):
95            assert self.indent_level == 0
96            if self.filename is not None:
97                self.file.close()
98    
99        def write_header(self, doctype, system):
100            """Write the XML header"""
101            self.file.write('<?xml version="1.0" encoding="UTF-8"?>\n')
102            self.file.write('<!DOCTYPE %s SYSTEM "%s">\n' % (doctype, system))
103    
104        def open_element(self, element, attrs = {}):
105    
106            #
107            # we note when an element is opened so that if two open_element()
108            # calls are made successively we can end the currently open
109            # tag and will later write a proper close tag. otherwise,
110            # if a close_element() call is made directly after an open_element()
111            # call we will close the tag with a />
112            #
113            if self.element_open == 1:
114                self.file.write(">\n")
115    
116            self.element_open = 1
117    
     def write_element(self, element, attrs, empty = 0, indentation = ""):  
118          # Helper function to write an element open tag with attributes          # Helper function to write an element open tag with attributes
119          self.file.write("%s<%s" % (indentation, element))          self.file.write("%s<%s" % (TAB*self.indent_level, element))
120          for name, value in attrs.items():          self.__write_attribs(attrs)
121              self.file.write(' %s="%s"' % (escape(name), escape(value)))  
122          if empty:          self.indent_level += 1
123    
124        def close_element(self, element):
125            self.indent_level -= 1
126            assert self.indent_level >= 0
127    
128            # see open_element() for an explanation
129            if self.element_open == 1:
130                self.element_open = 0
131              self.file.write("/>\n")              self.file.write("/>\n")
132          else:          else:
133              self.file.write(">\n")              self.file.write("%s</%s>\n" % (TAB*self.indent_level, element))
134    
135      def write_header(self):      def write_element(self, element, attrs = {}):
136          """Write the XML header"""          """write an element that won't need a closing tag"""
137          write = self.file.write          self.open_element(element, attrs)
138          write('<?xml version="1.0" encoding="UTF-8"?>\n')          self.close_element(element)
139          write('<!DOCTYPE session SYSTEM "thuban.dtd">\n')  
140        def __write_attribs(self, attrs):
141            for name, value in attrs.items():
142                self.file.write(' %s="%s"' % (escape(name), escape(value)))
143        
144    class SessionSaver(XMLWriter):
145    
146        """Class to serialize a session into an XML file.
147    
148        Applications built on top of Thuban may derive from this class and
149        override or extend the methods to save additional information. This
150        additional information should take the form of additional attributes
151        or elements whose names are prefixed with a namespace. To define a
152        namespace derived classes should extend the write_session method to
153        pass the namespaces to the default implementation.
154        """
155    
156    
157        def __init__(self, session):
158            XMLWriter.__init__(self)
159            self.session = session
160    
161        def write(self, file_or_filename):
162            XMLWriter.write(self, file_or_filename)
163    
164            self.write_header("session", "thuban.dtd")
165            self.write_session(self.session)
166            self.close()
167    
168      def write_session(self, session, attrs = None, namespaces = ()):      def write_session(self, session, attrs = None, namespaces = ()):
169          """Write the session and its contents          """Write the session and its contents
# Line 116  class Saver: Line 186  class Saver:
186          attrs["title"] = session.title          attrs["title"] = session.title
187          for name, uri in namespaces:          for name, uri in namespaces:
188              attrs["xmlns:" + name] = uri              attrs["xmlns:" + name] = uri
189          self.write_element("session", attrs)          self.open_element("session", attrs)
190          for map in session.Maps():          for map in session.Maps():
191              self.write_map(map)              self.write_map(map)
192          self.file.write('</session>\n')          self.close_element("session")
193    
194      def write_map(self, map):      def write_map(self, map):
195          """Write the map and its contents.          """Write the map and its contents.
# Line 129  class Saver: Line 199  class Saver:
199          element, call write_layer for each layer contained in the map          element, call write_layer for each layer contained in the map
200          and finally call write_label_layer to write the label layer.          and finally call write_label_layer to write the label layer.
201          """          """
202          write = self.file.write          self.open_element('map title="%s"' % escape(map.title))
         write('\t<map title="%s">\n' % escape(map.title))  
203          self.write_projection(map.projection)          self.write_projection(map.projection)
204          for layer in map.Layers():          for layer in map.Layers():
205              self.write_layer(layer)              self.write_layer(layer)
206          self.write_label_layer(map.LabelLayer())          self.write_label_layer(map.LabelLayer())
207          write('\t</map>\n')          self.close_element('map')
208    
209      def write_projection(self, projection):      def write_projection(self, projection):
210          """Write the projection.          """Write the projection.
211          """          """
212          if projection and len(projection.params) > 0:          if projection and len(projection.params) > 0:
213              self.file.write('\t\t<projection>\n')              self.open_element("projection",
214                                  {"name": escape(projection.GetName())})
215              for param in projection.params:              for param in projection.params:
216                  self.file.write('\t\t\t<parameter value="%s"/>\n'                  self.write_element('parameter value="%s"' % escape(param))
217                                  % escape(param))              self.close_element("projection")
             self.file.write('\t\t</projection>\n')  
218    
219      def write_layer(self, layer, attrs = None):      def write_layer(self, layer, attrs = None):
220          """Write the layer.          """Write the layer.
# Line 154  class Saver: Line 223  class Saver:
223          given, should be a mapping from attribute names to attribute          given, should be a mapping from attribute names to attribute
224          values. The values should not be XML-escaped yet.          values. The values should not be XML-escaped yet.
225          """          """
226            lc = layer.GetClassification()
227    
228          if attrs is None:          if attrs is None:
229              attrs = {}              attrs = {}
230          attrs["title"] = layer.title  
231          attrs["filename"] = relative_filename(self.dir, layer.filename)          attrs["title"]        = layer.title
232          attrs["stroke_width"] = str(layer.stroke_width)          attrs["filename"]     = relative_filename(self.dir, layer.filename)
233          fill = layer.fill          attrs["stroke"]       = lc.GetDefaultLineColor().hex()
234          if fill is None:          attrs["stroke_width"] = str(lc.GetDefaultLineWidth())
235              attrs["fill"] = "None"          attrs["fill"]         = lc.GetDefaultFill().hex()
236          else:          attrs["visible"]      = ("false", "true")[int(layer.Visible())]
237              attrs["fill"] = fill.hex()  
238          stroke = layer.stroke          self.open_element("layer", attrs)
239          if stroke is None:  
240              attrs["stroke"] = "None"          proj = layer.GetProjection()
241          else:          if proj is not None:
242              attrs["stroke"] = stroke.hex()              self.write_projection(proj)
243          self.write_element("layer", attrs, empty = 1, indentation = "\t\t")  
244            self.write_classification(layer)
245    
246            self.close_element("layer")
247    
248        def write_classification(self, layer, attrs = None):
249            if attrs is None:
250                attrs = {}
251    
252            lc = layer.GetClassification()
253    
254            field = lc.GetField()
255    
256            #
257            # there isn't a classification of anything
258            # so don't do anything
259            #
260            if field is None: return
261    
262            attrs["field"] = field
263            attrs["field_type"] = str(lc.GetFieldType())
264            self.open_element("classification", attrs)
265    
266    
267            types = [[lambda p: 'clnull label="%s"' % p.GetLabel(),
268                      lambda p: 'clnull'],
269                     [lambda p: 'clpoint label="%s" value="%s"' %
270                                 (p.GetLabel(), str(p.GetValue())),
271                      lambda p: 'clpoint'],
272                     [lambda p: 'clrange label="%s" min="%s" max="%s"' %
273                                 (p.GetLabel(),
274                                  str(p.GetMin()), (str(p.GetMax()))),
275                      lambda p: 'clrange']]
276    
277            def write_class_group(group):
278                type = -1
279                if isinstance(group, ClassGroupDefault): type = 0
280                elif isinstance(group, ClassGroupSingleton): type = 1
281                elif isinstance(group, ClassGroupRange): type = 2
282                elif isinstance(group, ClassGroupMap):   type = 3
283                assert type >= 0
284    
285                if type <= 2:
286                    data = group.GetProperties()
287                    dict = {'stroke'      : data.GetLineColor().hex(),
288                            'stroke_width': str(data.GetLineWidth()),
289                            'fill'        : data.GetFill().hex()}
290    
291                    self.open_element(types[type][0](group))
292                    self.write_element("cldata", dict)
293                    self.close_element(types[type][1](group))
294                else: pass # XXX: we need to handle maps
295    
296            for i in lc:
297                write_class_group(i)
298    
299            self.close_element("classification")
300    
301      def write_label_layer(self, layer):      def write_label_layer(self, layer):
302          """Write the label layer.          """Write the label layer.
303          """          """
304          labels = layer.Labels()          labels = layer.Labels()
305          if labels:          if labels:
306              self.file.write('\t\t<labellayer>\n')              self.open_element('labellayer')
307              for label in labels:              for label in labels:
308                  self.file.write(('\t\t\t<label x="%g" y="%g" text="%s"'                  self.write_element(('label x="%g" y="%g" text="%s"'
309                                   ' halign="%s" valign="%s"/>\n')                                      ' halign="%s" valign="%s"')
310                                  % (label.x, label.y, label.text, label.halign,                                  % (label.x, label.y, label.text, label.halign,
311                                     label.valign))                                     label.valign))
312              self.file.write('\t\t</labellayer>\n')              self.close_element('labellayer')
313    
314    
315    
# Line 193  def save_session(session, file, saver_cl Line 320  def save_session(session, file, saver_cl
320    
321      The optional argument saver_class is the class to use to serialize      The optional argument saver_class is the class to use to serialize
322      the session. By default or if it's None, the saver class will be      the session. By default or if it's None, the saver class will be
323      Saver.      SessionSaver.
324    
325      If writing the session is successful call the session's      If writing the session is successful call the session's
326      UnsetModified method      UnsetModified method
327      """      """
328      if saver_class is None:      if saver_class is None:
329          saver_class = Saver          saver_class = SessionSaver
330      saver = saver_class(session)      saver = saver_class(session)
331      saver.write(file)      saver.write(file)
332    
Legend:
Removed from v.268  
changed lines
  Added in v.773
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26