ViewVC Help
View File | Revision Log | Show Annotations | Root Listing
root/cvsroot/COMP/SCRAM/src/ActiveDoc/ActiveDoc.pm
(Generate patch)

Comparing COMP/SCRAM/src/ActiveDoc/ActiveDoc.pm (file contents):
Revision 1.24 by williamc, Wed Mar 1 11:47:39 2000 UTC vs.
Revision 1.25.2.1.2.6 by williamc, Mon Aug 21 18:40:13 2000 UTC

# Line 7 | Line 7
7   #
8   # Interface
9   # ---------
10 < # new(ActiveConfig[,options])           : A new ActiveDoc object
10 > # new(cache,dbstore)            : A new ActiveDoc object
11   # url()         : Return/set the docs url - essential
12   # file()        : Return the local filename of document
13   # ProcessFile() : Return the filename of PreProcessed document
14   #
15 # parse(parselabel): Parse the document file for the given parse level
15   # parent()         : return the object ref of the calling parent
17 # newparse(parselabel) : Create a new parse type
18 # addtag(parselabel,tagname,start,obj,text,obj,end,obj)
19 #                               : Add tags to the parse given by label
20 # checktag(tagname, hashref, param) : check for existence of param in
21 #                                       hashref from a tag call
22 # includeparse(local_parsename, objparsename, activedoc) : copy the parse from
23 #                                                       one object to another
24 # currentparser() : return the current parser object
25 # currentparsename([name]) : get/set current parse name
16   # getfile(url)  : get a processedfile object given a url
17   # activatedoc(url) : Return the object ref for a doc described by the given url
28 #                    -- any parse called "init" will also be run
29 # config([ActiveConfig]) : Set up/return Configuration for the document
30 # basequery([ActiveConfig]) : Set up/return UserQuery for the doc
31 # copydocconfig(ActiveDoc) : Copy the basic configuration from the ActiveDoc
32 # copydocquery(ActiveDoc) : Copy the basicquery from the ActiveDoc
33 # userinterface()       : Return the defaullt userinterface
34 # option(var)           : return the value of the option var ( or undef )
35 # requestoption("message") : Ask the user to supply a value for an option
36 #                            if it dosnt already exist
37 # askuser(Query)        : send a query object to the userinterface
38 # verbose(string)       : Print string in verbosity mode
18   #
19   # -- error methods --
20   # error(string)       : Report an general error to the user
21   # parseerror(string)  : Report an error during parsing a file
22 < # line()              : Return the current line number of the document
23 < #                       and the ProcessedFileObj it is in
24 < #
25 < # -- support for inheriting classes
47 < # _saveactivedoc(filehandle)
48 < # _restoreactivedoc(filehandle)
22 > # line([linenumber])     : Return the line number of the document
23 > #                       and the ProcessedFileObj it is in corresponding to the
24 > #                       supplied number of the expanded document
25 > #                       If no number supplied - the currentparse number will be #                       used
26  
27   package ActiveDoc::ActiveDoc;
28   require 5.004;
29 < use ActiveDoc::Parse;
53 < use ActiveDoc::ActiveConfig;
29 > use ActiveDoc::SimpleURLDoc;
30   use ActiveDoc::PreProcessedFile;
31 < use ObjectUtilities::StorableObject;
56 < use URL::URLhandler;
31 > use Utilities::Verbose;
32  
33 < @ISA = qw(ObjectUtilities::StorableObject);
33 > @ISA = qw(ActiveDoc::SimpleURLDoc Utilities::Verbose);
34  
35   sub new {
36          my $class=shift;
37 <        $self={};
37 >        my $self={};
38          bless $self, $class;
39 <        $self->config(shift);
40 <
41 <        # have some override options been passed
42 <        if ( @_ ) {
68 <           $self->basequery(shift);
69 <        }
70 <        else {
71 <           # --- is there a starter document?
72 <           my $basedoc=$self->config()->basedoc();
73 <           if ( defined $basedoc ) {
74 <             $self->copydocquery($basedoc);
75 <             $self->verbose("Initialising from $basedoc");
76 <           }
77 <           else {
78 <             $self->error("ActiveDoc Error : No base doc found");
79 <           }
80 <        }
81 <        $self->verbose("New ActiveDoc (".ref($self).") Created");
82 <        $self->_init2();
83 < }
84 <
85 < sub _init2 {
86 <
87 <        my $self=shift;
88 <        # A URL handler per document
89 <        $self->{urlhandler}=URL::URLhandler->new($self->config()->cache());
90 <
91 <        # A default UserInterface
92 <        $self->{userinterface}=ActiveDoc::SimpleUserInterface->new();
93 <        $self->init(@_);
39 >        $self->cache(shift);
40 >        $self->{dbstore}=shift;
41 >        $self->_initdoc("doc",@_);
42 > #       $self->{switch}=ActiveDoc::SimpleURLDoc->new($self->{cache});
43          return $self;
95
96 }
97
98 sub verbose {
99        my $self=shift;
100        my $string=shift;
101
102        if ( $self->option('verbose_all') ||
103                        $self->option('verbose_'.ref($self)) ) {
104          print ">".ref($self)."($self) : \n->".$string."\n";
105        }
106 }
107
108 # ----- parse related routines --------------
109 sub parse {
110        my $self=shift;
111        $parselabel=shift;
112
113        my $file=$self->ProcessFile();
114        if ( $file ) {
115          if ( exists $self->{parsers}{$parselabel} ) {
116            $self->verbose("Parsing $parselabel in file $file");
117            $self->{currentparsename}=$parselabel;
118            $self->{currentparser}=$self->{parsers}{$parselabel};
119            $self->{parsers}{$parselabel}->parse($file,@_);
120            delete $self->{currentparser};
121            $self->{currentparsename}="";
122            $self->verbose("Parse $parselabel Complete");
123          }
124        }
125        else {
126          $self->error("Cannot parse $parselabel - file not known");
127        }
128 }
129
130 sub currentparsename {
131        my $self=shift;
132        @_?$self->{currentparsename}=shift
133          :(defined $self->{currentparsename}?$self->{currentparsename}:"");
134 }
135
136 sub currentparser {
137        my $self=shift;
138        return $self->{currentparser};
139 }
140
141
142 sub newparse {
143        my $self=shift;
144        my $parselabel=shift;
145
146        $self->{parsers}{$parselabel}=ActiveDoc::Parse->new();
147        $self->{parsers}{$parselabel}->addignoretags();
148        $self->{parsers}{$parselabel}->addgrouptags();
149 }
150
151 sub cleartags {
152        my $self=shift;
153        my $parselabel=shift;
154
155        $self->{parsers}{$parselabel}->cleartags();
156 }
157
158
159 sub includeparse {
160        my $self=shift;
161        my $parselabel=shift;
162        my $remoteparselabel=shift;
163        my $activedoc=shift;
164
165        # Some error trapping
166        if ( ! exists $self->{parsers}{$parselabel} ) {
167          $self->error("Unknown local parse name specified");
168        }
169        if ( ! exists $activedoc->{parsers}{$remoteparselabel} ) {
170          $self->error("Unknown parse name specified in remote obj $activedoc");
171        }
172
173        #
174        my $rp=$activedoc->{parsers}{$remoteparselabel};
175        $self->{parsers}{$parselabel}->includeparse($rp);
176 }
177
178 sub addtag {
179        my $self=shift;
180        my $parselabel=shift;
181        if ( $#_ != 6 ) {
182                $self->error("Incorrect addtags specification\n".
183                                "called with :\n@_ \n");
184        }
185        $self->{parsers}{$parselabel}->addtag(@_);
186 }
187
188 sub addurltags {
189        my $self=shift;
190        my $parselabel=shift;
191        
192        $self->{parsers}{$parselabel}->
193                addtag("Base", \&Base_start, $self, "", $self,
194                        \&Base_end, $self);
44   }
45  
46   sub url {
47          my $self=shift;
48          # get file & preprocess
49          if ( @_  ) {
50 <                $self->{File}=$self->getfile(shift);
51 <                $self->verbose("url downloaded to $self->{File}");
50 >                $self->{origurl}=shift;
51 >                $self->{File}=$self->getfile($self->{origurl});
52 >                $self->filetoparse($self->{File}->ProcessedFile());
53 >                $self->verbose("url downloaded to ".$self->{File}->ProcessedFile());
54          }
55 <        $self->{File}->url();
56 < }
206 <
207 < sub copydocconfig {
208 <        my $self=shift;
209 <        my $ActiveDoc=shift;
210 <        
211 <        $self->config($ActiveDoc->config());
212 <
213 < }
214 <
215 < sub copydocquery {
216 <        my $self=shift;
217 <        my $ActiveDoc=shift;
218 <
219 <        if ( defined $ActiveDoc->basequery() ) {
220 <          $self->basequery($ActiveDoc->basequery());
221 <        }
222 <        else {
223 <          $self->error("Cannot copy basequery - undefined");
224 <        }
225 < }
226 <
227 < sub config {
228 <        my $self=shift;
229 <        @_?$self->{ActiveConfig}=shift
230 <           : $self->{ActiveConfig};
231 < }
232 <
233 < sub basequery {
234 <        my $self=shift;
235 <        @_?$self->{Query}=shift
236 <           :$self->{Query};
237 < }
238 <
239 < sub option {
240 <        my $self=shift;
241 <        my $param=shift;
242 <        if ( defined $self->basequery()) {
243 <                return $self->basequery()->getparam($param);
244 <        }
245 <        else {
246 <                return $undef;
247 <        }
248 < }
249 <
250 < sub requestoption {
251 <        my $self=shift;
252 <        my $param=shift;
253 <        my $string=shift;
254 <
255 <        my $par=undef;
256 <        if ( defined $self->basequery()) {
257 <        $par=$self->basequery()->getparam($param);
258 <        while ( ! defined $par ) {
259 <          $self->basequery()->querytype( $param, "basic");
260 <          $self->basequery()->querymessage( $param, $string);
261 <          $self->userinterface()->askuser($self->basequery());
262 <          $par=$self->basequery()->getparam($param);
263 <        }
55 >        if ( defined $self->{File} ) {
56 >          return $self->{File}->url();
57          }
58 <        return $par;
266 < }
267 <
268 < sub askuser {
269 <        my $self=shift;
270 <        return $self->userinterface()->askuser(@_);
58 >        else { return "undefined"; }
59   }
60  
61   sub getfile {
# Line 276 | Line 64 | sub getfile {
64  
65          my $fileref;
66          my ($url, $file);
67 <        if ( (defined ($it=$self->option('url_update'))) &&
280 <                ( $it eq "1" || $origurl=~/^$it/ )) {
67 >        if ( 0 ) {
68               $self->verbose("Forced download of $origurl");
69 <             ($url, $file)=$self->{urlhandler}->download($origurl);
69 >             ($url, $file)=$self->urldownload($origurl);
70          }
71          else {
72             $self->verbose("Attempting to get $origurl");
73 <           ($url, $file)=$self->{urlhandler}->get($origurl);
73 >           ($url, $file)=$self->urlget($origurl);
74          }
75          # do we already have an appropriate object?
76 <        ($fileref)=$self->config()->find($url);
290 <        #undef $fileref;
76 >        ($fileref)=$self->{dbstore}->find($url);
77          if (  defined $fileref ) {
78           $self->verbose("Found $url in database");
79           $fileref->update();
# Line 296 | Line 82 | sub getfile {
82           if ( $file eq "" ) {
83             $self->parseerror("Unable to get $origurl");
84           }
85 <         #-- set up a new preprocess file
85 >         # -- set up a new preprocess file
86           $self->verbose("Making a new preprocessed file $url");
87 <         $fileref=ActiveDoc::PreProcessedFile->new($self->config());
87 >         $fileref=ActiveDoc::PreProcessedFile->new($self->{dbstore});
88 >         $fileref->cache($self->{cache});
89           $fileref->url($url);
90           $fileref->update();
91          }
# Line 310 | Line 97 | sub activatedoc {
97          my $url=shift;
98  
99          # first get a preprocessed copy of the file
100 < #       my $fileob=$self->getfile($url);
100 >        my $fileobj=$self->getfile($url);
101  
102 <        # now parse it for the <DocType> tag
103 <        my $tempdoc=ActiveDoc::ActiveDoc->new($self->config());
104 <        $tempdoc->{urlhandler}=$self->{urlhandler};
105 <        my $fullurl=$tempdoc->url($url);
106 <        $url=$fullurl;
107 <        $tempdoc->{doctypefound}=0;
108 <        $tempdoc->newparse("doctype");
109 <        $tempdoc->addtag("doctype","Doc", \&Doc_Start, $tempdoc,
323 <                                          "", $tempdoc, "", $tempdoc);
324 <        $tempdoc->parse("doctype");
325 <
326 <        if ( ! defined $tempdoc->{docobject} ) {
327 <          print "No <Doc type=> Specified in ".$url."\n";
328 <          exit 1;
102 >        # now parse it for the <Doc> tag
103 >        my $tempdoc=ActiveDoc::SimpleURLDoc->new($self->{cache});
104 >        $tempdoc->filetoparse($fileobj->ProcessFile());
105 >        my ($doctype,$docversion)=$tempdoc->doctype();
106 >        undef $tempdoc;
107 >        
108 >        if ( ! defined $doctype ) {
109 >          $self->parseerror("No <Doc type=> Specified in ".$url);
110          }
111 +        $self->verbose("doctype required is $doctype $docversion");
112 +
113          # Set up a new object of the specified type
114 <        eval "require $tempdoc->{docobject}";
114 >        eval "require $doctype";
115          die $@ if $@;
116 <        my $newobj=$tempdoc->{docobject}->new($self->config());
334 <        undef $tempdoc;
116 >        my $newobj=$doctype->new($self->{cache},$self->{dbstore});
117          $newobj->url($url);
118          $newobj->parent($self);
337        $newobj->_initparse();
119          return $newobj;
120   }
121  
# Line 345 | Line 126 | sub parent {
126            :$self->{parent};
127   }
128  
348 sub _initparse {
349        my $self=shift;
350
351        $self->parse("init");
352 }
129   # -------- Error Handling and Error services --------------
130  
355 sub error {
356        my $self=shift;
357        my $string=shift;
358
359        die $string."\n";
360 }
361
131   sub parseerror {
132          my $self=shift;
133          my $string=shift;
# Line 366 | Line 135 | sub parseerror {
135          if ( $self->currentparsename() eq "" ) {
136                  $self->error($string);
137          }
138 +        elsif ( ! defined $self->{File} ) {
139 +         print "Parse Error in ".$self->filenameref()." line "
140 +                                .$self->{currentparser}->line()."\n";
141 +         print $string."\n";
142 +        }
143          else {
144           ($line, $file)=$self->line();
145           print "Parse Error in ".$file->url().", line ".
146                                          $line."\n";
147           print $string."\n";
374         exit;
148          }
149 < }
377 <
378 < sub checktag {
379 <        my $self=shift;
380 <        my $tagname=shift;
381 <        my $hashref=shift;
382 <        my $param=shift;
383 <
384 <        if ( ! exists $$hashref{$param} ) {
385 <          $self->parseerror("Incomplete Tag <$tagname> : $param required");
386 <        }
149 >        exit;
150   }
151  
152   sub line {
153          my $self=shift;
154 +        my $parseline;
155 +
156 +        if ( @_ ) {
157 +          $parseline=shift;
158 +        }
159 +        else {
160 +          $parseline=$self->{currentparser}->line();
161 +        }
162  
163          my ($line, $fileobj)=
164 <                $self->{File}->realline($self->{currentparser}->line());
164 >                $self->{File}->realline($parseline);
165          return ($line, $fileobj);
166   }
167  
# Line 413 | Line 184 | sub ProcessFile {
184          return $self->{File}->ProcessedFile();
185   }
186  
416 # --------------- Initialisation Methods ---------------------------
417
418 sub init {
419        # Dummy Routine - override for derived classes
420 }
421
422 # ------------------- Tag Routines -----------------------------------
187   #
188 < # Base - for setting url bases
188 > # Delegate all else to the switch
189   #
190 < sub Base_start {
191 <        my $self=shift;
428 <        my $name=shift;
429 <        my $hashref=shift;
190 > #sub AUTOLOAD {
191 > #        my $self=shift;
192  
193 <        $self->checktag($name, $hashref, 'type' );
194 <        $self->checktag($name, $hashref, 'base' );
433 <      
434 <        # Keep track of base tags
435 <        push @{$self->{basestack}}, $$hashref{"type"};
436 <        # Set the base
437 <        $self->{urlhandler}->setbase($$hashref{"type"},$hashref);
438 < }
193 >        # dont propogate destroy methods
194 > #        return if $AUTOLOAD=~/::DESTROY/;
195  
196 < sub Base_end {
197 <        my $self=shift;
442 <        my $name=shift;
443 <        my $type;
196 >        # remove this package name
197 > #        ($name=$AUTOLOAD)=~s/ActiveDoc::ActiveDoc:://;
198  
199 <        if ( $#{$self->{basestack}} == -1 ) {
200 <                $self->parseerror("Parse Error : unmatched </$name>");
201 <        }
448 <        else {
449 <          $type = pop @{$self->{basestack}};
450 <          $self->{urlhandler}->unsetbase($type);
451 <        }
452 < }
199 >        # pass the message to SimpleDoc
200 > #        $self->{switch}->$name(@_);
201 > #}
202  
203 +
204 + # ------------------- Tag Routines -----------------------------------
205   sub Doc_Start {
206          my $self=shift;
207          my $name=shift;
# Line 462 | Line 213 | sub Doc_Start {
213             $self->{docobject}=$$hashref{'type'};
214          }
215   }
465
466 sub userinterface {
467        my $self=shift;
468        @_?$self->{userinterface}=shift
469          :$self->{userinterface}
470 }
471
472 sub _saveactivedoc {
473        my $self=shift;
474        my $fh=shift;
475        print "Storing $self\n";
476        print $fh $self->url()."\n";
477 }
478
479 sub _restoreactivedoc {
480        my $self=shift;
481        my $fh=shift;
482
483        my $url=<$fh>;
484        chomp $url;
485        $self->url($url);
486 }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines