| 1 |
#
|
| 2 |
# UserQuery
|
| 3 |
#
|
| 4 |
# Set up and record Queries requested from the user
|
| 5 |
#
|
| 6 |
# Interface
|
| 7 |
# ---------
|
| 8 |
# new(UserInterface) : A new query object with a specific interface
|
| 9 |
# dump(fh,expr) : dump out parameters that match expr to filehandle
|
| 10 |
# store(fh) : dump every param to fh
|
| 11 |
# restore(fh) : restore from filehandle
|
| 12 |
# params() : return list of all params
|
| 13 |
# setparam(name,value) : set a parameter
|
| 14 |
# setifundef(name,value) : only set param to value if undefined
|
| 15 |
# getparam(name) : return value of named parameter
|
| 16 |
# clearquery() : remove all queries to be asked
|
| 17 |
# setquery($type,$parameter,$string,@args) : register a query of type for
|
| 18 |
# $parameter
|
| 19 |
# querycheck(name, checkobject) : Set a checksum to be made on each query
|
| 20 |
# addquerymessage(name,string) : Add an extra message to the query for name
|
| 21 |
# askuser() : Ask user registered queries
|
| 22 |
# formatquery(args) : apply formatting information for display
|
| 23 |
# of the query . args dependent on implemtation
|
| 24 |
# query type etc.
|
| 25 |
# interface() : Return the interface object for the query
|
| 26 |
|
| 27 |
package ActiveDoc::UserQuery;
|
| 28 |
require 5.001;
|
| 29 |
|
| 30 |
sub new {
|
| 31 |
my $class=shift;
|
| 32 |
my $interface=shift;
|
| 33 |
$self={};
|
| 34 |
bless $self, $class;
|
| 35 |
$self->{params}={};
|
| 36 |
$self->{UserInterface}=$interface;
|
| 37 |
return $self;
|
| 38 |
}
|
| 39 |
|
| 40 |
sub dump {
|
| 41 |
my $self=shift;
|
| 42 |
my $fh=shift;
|
| 43 |
my $string=shift;
|
| 44 |
|
| 45 |
foreach $key ( keys %{$self->{params}} ) {
|
| 46 |
if ( $key=~/$string/ ) {
|
| 47 |
print $fh "k:".$key."\n";
|
| 48 |
print $fh "v:".$self->{params}{$key}."\n";
|
| 49 |
}
|
| 50 |
}
|
| 51 |
print $fh "#End\n";
|
| 52 |
}
|
| 53 |
|
| 54 |
sub store {
|
| 55 |
my $self=shift;
|
| 56 |
my $fh=shift;
|
| 57 |
|
| 58 |
my $key;
|
| 59 |
foreach $key ( keys %{$self->{params}} ) {
|
| 60 |
print $fh "k:".$key."\n";
|
| 61 |
print $fh "v:".$self->{params}{$key}."\n";
|
| 62 |
}
|
| 63 |
print $fh "#End\n";
|
| 64 |
}
|
| 65 |
|
| 66 |
sub restore {
|
| 67 |
my $self=shift;
|
| 68 |
my $fh=shift;
|
| 69 |
|
| 70 |
my $check="k:";
|
| 71 |
my $key="";
|
| 72 |
while ( $line=<$fh> ) {
|
| 73 |
chomp $line;
|
| 74 |
last if ( $line eq "\#End" );
|
| 75 |
if ( $line!~/^$check/ ) {
|
| 76 |
die "Data Corruption Error when restoring $self\n";
|
| 77 |
}
|
| 78 |
if ( $check eq "k:" ) {
|
| 79 |
$check="v:";
|
| 80 |
($key=$line)=~s/k://;
|
| 81 |
}
|
| 82 |
else {
|
| 83 |
$check="k:";
|
| 84 |
($value=$line)=~s/v://;
|
| 85 |
$self->setparam($key,$value);
|
| 86 |
}
|
| 87 |
} #end while
|
| 88 |
}
|
| 89 |
|
| 90 |
sub setparam {
|
| 91 |
my $self=shift;
|
| 92 |
my $name=shift;
|
| 93 |
my $value=shift;
|
| 94 |
|
| 95 |
print "Setting $name = $value\n";
|
| 96 |
$self->{params}{$name}=$value;
|
| 97 |
}
|
| 98 |
|
| 99 |
sub params {
|
| 100 |
my $self=shift;
|
| 101 |
|
| 102 |
return ( keys %{$self->{params}} );
|
| 103 |
}
|
| 104 |
|
| 105 |
sub setifundef {
|
| 106 |
my $self=shift;
|
| 107 |
my $name=shift;
|
| 108 |
my $value=shift;
|
| 109 |
|
| 110 |
if ( ! defined $self->getparam($name) ) {
|
| 111 |
$self->setparam($name, $value);
|
| 112 |
}
|
| 113 |
}
|
| 114 |
|
| 115 |
sub getparam {
|
| 116 |
my $self=shift;
|
| 117 |
my $name=shift;
|
| 118 |
return $self->{params}{$name};
|
| 119 |
}
|
| 120 |
|
| 121 |
sub clearquery {
|
| 122 |
my $self=shift;
|
| 123 |
undef %self->{querytype};
|
| 124 |
undef %self->{queryvars};
|
| 125 |
undef @{$self->{queries}};
|
| 126 |
undef %{$self->{queryformat}};
|
| 127 |
}
|
| 128 |
|
| 129 |
sub setquery {
|
| 130 |
my $self=shift;
|
| 131 |
my $type=shift;
|
| 132 |
my $name=shift;
|
| 133 |
my $string=shift;
|
| 134 |
my @vars=@_;
|
| 135 |
|
| 136 |
push @{$self->{queries}},$name;
|
| 137 |
$self->{querytype}{$name}=$type;
|
| 138 |
$self->{querystring}{$name}=$string;
|
| 139 |
for ( $i=0; $i<=$#vars; $i++ ) {
|
| 140 |
$self->{queryvars}{$name}[$i]=$vars[$i];
|
| 141 |
}
|
| 142 |
}
|
| 143 |
|
| 144 |
sub querycheck {
|
| 145 |
my $self=shift;
|
| 146 |
my $name=shift;
|
| 147 |
my $check=shift;
|
| 148 |
|
| 149 |
$self->{querycheck}{$name}=$check;
|
| 150 |
}
|
| 151 |
|
| 152 |
sub addquerymessage {
|
| 153 |
my $self=shift;
|
| 154 |
my $name=shift;
|
| 155 |
my $string=shift;
|
| 156 |
$self->{querystring}{$name}=$self->{querystring}{$name}.$string;
|
| 157 |
}
|
| 158 |
|
| 159 |
sub formatquery {
|
| 160 |
my $self=shift;
|
| 161 |
|
| 162 |
my $name=$self->{queries}[$#$self->{queries}];
|
| 163 |
$self->{queryformat}{$name}= @_;
|
| 164 |
}
|
| 165 |
|
| 166 |
sub askuser {
|
| 167 |
my $self=shift;
|
| 168 |
my $string=shift;
|
| 169 |
|
| 170 |
$self->{UserInterface}->startform($string);
|
| 171 |
foreach $query ( @{$self->{queries}} ) {
|
| 172 |
my @rqargs=($self->{querytype}{$query}, $query,
|
| 173 |
$self->{querystring}{$query},
|
| 174 |
$self->{queryvars}{$query}, $self->{queryformat}{$query});
|
| 175 |
if ( exists $self->{querycheck}{$query} ) {
|
| 176 |
$self->{UserInterface}->runcheckedquery(
|
| 177 |
$self->{querycheck}{$query}, @rqargs);
|
| 178 |
}
|
| 179 |
else {
|
| 180 |
$self->{UserInterface}->runquery(@rqargs);
|
| 181 |
}
|
| 182 |
}
|
| 183 |
$self->{UserInterface}->endform($self);
|
| 184 |
}
|
| 185 |
|
| 186 |
sub interface {
|
| 187 |
my $self=shift;
|
| 188 |
return $self->{UserInterface};
|
| 189 |
}
|
