| Revision: | 1.6 |
| Committed: | Tue Feb 27 11:59:42 2007 UTC (18 years, 2 months ago) by sashby |
| Content type: | text/plain |
| Branch: | MAIN |
| CVS Tags: | V1_2_1b, V1_2_1a, V1_2_3, V1_2_2, V1_2_2_relcand2, V1_2_2_relcand1, V1_2_1, V1_2_0, V1_2_0-cand11, V1_1_7, V1_1_6, V1_2_0-cand10, V1_1_5, V1_2_0-cand9, V1_2_0-cand8, V1_2_0-cand7, V1_2_0-cand6, V1_2_0-cand5, V1_2_0-cand4, V1_2_0-cand3, V1_2_0-cand2, V1_2_0-cand1, V1_1_4, V1_1_3, V1_1_2, V1_1_0_reltag8, V1_1_0_reltag7, V1_1_0_reltag6, V1_1_1, V1_1_0_reltag5, V1_1_0_reltag4, V1_1_0_reltag3, V1_1_0_reltag2, V1_1_0_reltag1, V1_1_0_reltag, V1_1_0_cand3, V1_1_0_cand2, V1_1_0_cand1, HEAD_SM_071214, V1_1_0, v110p1, V110p6, V110p5, V110p4, V110p3 |
| Branch point for: | SCRAM_V2_0, forBinLess_SCRAM, HEAD_BRANCH_SM_071214, v200branch |
| Changes since 1.5: | +79 -83 lines |
| Log Message: | Merged from XML branch to HEAD. Start release prep. |
| # | User | Rev | Content |
|---|---|---|---|
| 1 | williamc | 1.2 | # |
| 2 | # SimpleURLDoc.pm. - Extends SimpleDoc with URL download functionality | ||
| 3 | # | ||
| 4 | # Originally Written by Christopher Williams | ||
| 5 | # | ||
| 6 | # Description | ||
| 7 | # ----------- | ||
| 8 | # | ||
| 9 | # Interface | ||
| 10 | # --------- | ||
| 11 | # new(URLcache[,DocVersionTag] : A new SimpleURLDoc object. You can also | ||
| 12 | # specify an alternative doc version tag | ||
| 13 | # urlget(urlstring[,location]) : get the given url - using the cache. | ||
| 14 | # Returns (url, filename) | ||
| 15 | # urldownload(urlstring[,location]) : get the given url ignoring any cached | ||
| 16 | # version. Returns (url, filename) | ||
| 17 | # expandurl(urlstring) : return a URLclass object of the given url expanded | ||
| 18 | # according to the base settings | ||
| 19 | # cache([cache]) : get/set the current URL cache | ||
| 20 | |||
| 21 | package ActiveDoc::SimpleURLDoc; | ||
| 22 | use ActiveDoc::SimpleDoc; | ||
| 23 | use URL::URLhandler; | ||
| 24 | require 5.001; | ||
| 25 | @ISA=qw(ActiveDoc::SimpleDoc); | ||
| 26 | |||
| 27 | sashby | 1.6 | sub new() |
| 28 | { | ||
| 29 | my $class=shift; | ||
| 30 | my $self={}; | ||
| 31 | bless $self, $class; | ||
| 32 | my ($cache)=@_; | ||
| 33 | $self->cache($cache); | ||
| 34 | return $self; | ||
| 35 | } | ||
| 36 | |||
| 37 | sub cache() | ||
| 38 | { | ||
| 39 | my $self=shift; | ||
| 40 | if ( @_ ) | ||
| 41 | { | ||
| 42 | $self->{cache}=shift; | ||
| 43 | $self->{urlhandler}=URL::URLhandler->new($self->{cache}); | ||
| 44 | } | ||
| 45 | return $self->{cache}; | ||
| 46 | } | ||
| 47 | |||
| 48 | sub expandurl() | ||
| 49 | { | ||
| 50 | my $self=shift; | ||
| 51 | my $urlstring=shift; | ||
| 52 | |||
| 53 | return $self->{urlhandler}->expandurl($urlstring); | ||
| 54 | } | ||
| 55 | |||
| 56 | sub urldownload() | ||
| 57 | { | ||
| 58 | my $self=shift; | ||
| 59 | my $urlstring=shift; | ||
| 60 | |||
| 61 | ($fullurl,$filename)=$self->{urlhandler}->download($urlstring, @_); | ||
| 62 | if ( ( ! defined $filename ) || ( $filename eq "" ) ) | ||
| 63 | { | ||
| 64 | $self->parseerror("Failed to get $fullurl"); | ||
| 65 | } | ||
| 66 | return ($fullurl,$filename); | ||
| 67 | } | ||
| 68 | |||
| 69 | sub urlget() | ||
| 70 | { | ||
| 71 | my $self=shift; | ||
| 72 | my $urlstring=shift; | ||
| 73 | |||
| 74 | ($fullurl,$filename)=$self->{urlhandler}->get($urlstring, @_); | ||
| 75 | sashby | 1.5 | |
| 76 | sashby | 1.6 | if ( ( ! defined $filename ) || ( $filename eq "" ) ) |
| 77 | { | ||
| 78 | $self->parseerror("Failed to get $fullurl"); | ||
| 79 | } | ||
| 80 | return ($fullurl,$filename); | ||
| 81 | } | ||
| 82 | williamc | 1.2 | |
| 83 | # ------------------------ Tag Routines ------------------------------- | ||
| 84 | sashby | 1.6 | sub base() |
| 85 | { | ||
| 86 | my $self=shift; | ||
| 87 | my (%attributes)=@_; | ||
| 88 | my $url=$self->{urlhandler}->setbase($attributes{'url'}); | ||
| 89 | # Add store for url of the file currently being parsed. This info can | ||
| 90 | # then be extracted in Requirements objects | ||
| 91 | $self->{configurl}=$url; | ||
| 92 | push @{$self->{basestack}}, $url->type(); | ||
| 93 | } | ||
| 94 | |||
| 95 | sub base_() | ||
| 96 | { | ||
| 97 | my $self=shift; | ||
| 98 | if ( $#{$self->{basestack}} >= 0 ) | ||
| 99 | { | ||
| 100 | my $type=pop @{$self->{basestack}}; | ||
| 101 | $self->{urlhandler}->unsetbase($type); | ||
| 102 | } | ||
| 103 | else | ||
| 104 | { | ||
| 105 | $self->parseerror("Unmatched <$name>"); | ||
| 106 | } | ||
| 107 | } | ||
| 108 | williamc | 1.2 | |
| 109 | sashby | 1.6 | 1; |