ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/lib/cf.pm
(Generate patch)

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.53 by root, Tue Aug 29 13:11:58 2006 UTC vs.
Revision 1.69 by root, Mon Sep 18 01:10:35 2006 UTC

11use Event; 11use Event;
12$Event::Eval = 1; # no idea why this is required, but it is 12$Event::Eval = 1; # no idea why this is required, but it is
13 13
14use strict; 14use strict;
15 15
16_reload_1; 16_init_vars;
17 17
18our %COMMAND = (); 18our %COMMAND = ();
19our @EVENT; 19our @EVENT;
20our %PROP_TYPE;
21our %PROP_IDX;
22our $LIBDIR = maps_directory "perl"; 20our $LIBDIR = maps_directory "perl";
23 21
24our $TICK = MAX_TIME * 1e-6; 22our $TICK = MAX_TIME * 1e-6;
25our $TICK_WATCHER; 23our $TICK_WATCHER;
26our $NEXT_TICK; 24our $NEXT_TICK;
34 print STDERR "cfperl: $msg"; 32 print STDERR "cfperl: $msg";
35 LOG llevError, "cfperl: $msg"; 33 LOG llevError, "cfperl: $msg";
36 }; 34 };
37} 35}
38 36
39my %ignore_set = (MAP_PROP_PATH => 1); # I hate the plug-in api. Deeply!
40
41# generate property mutators
42sub prop_gen {
43 my ($prefix, $class) = @_;
44
45 no strict 'refs';
46
47 for my $prop (keys %PROP_TYPE) {
48 $prop =~ /^\Q$prefix\E_(.*$)/ or next;
49 my $sub = lc $1;
50
51 my $type = $PROP_TYPE{$prop};
52 my $idx = $PROP_IDX {$prop};
53
54 *{"$class\::get_$sub"} = *{"$class\::$sub"} = sub {
55 $_[0]->get_property ($type, $idx)
56 };
57
58 *{"$class\::set_$sub"} = sub {
59 $_[0]->set_property ($type, $idx, $_[1]);
60 } unless $ignore_set{$prop};
61 }
62}
63
64# auto-generate most of the API
65
66prop_gen OBJECT_PROP => "cf::object";
67# CFAPI_OBJECT_ANIMATION?
68prop_gen PLAYER_PROP => "cf::object::player";
69
70prop_gen MAP_PROP => "cf::map";
71prop_gen ARCH_PROP => "cf::arch";
72
73@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; 37@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';
74 38
75# we bless all objects into (empty) derived classes to force a method lookup 39# we bless all objects into (empty) derived classes to force a method lookup
76# within the Safe compartment. 40# within the Safe compartment.
77for my $pkg (qw(cf::object cf::object::player cf::player cf::map cf::party cf::region cf::arch cf::living)) { 41for my $pkg (qw(cf::object cf::object::player cf::player cf::map cf::party cf::region cf::arch cf::living)) {
105} 69}
106 70
107############################################################################# 71#############################################################################
108# "new" plug-in system 72# "new" plug-in system
109 73
74=head3 EVENTS AND OBJECT ATTACHMENTS
75
76=over 4
77
110=item $object->attach ($attachment, key => $value...) 78=item $object->attach ($attachment, key => $value...)
111 79
112=item $object->detach ($attachment) 80=item $object->detach ($attachment)
113 81
114Attach/detach a pre-registered attachment to an object. 82Attach/detach a pre-registered attachment to an object.
122=item $map->attach ($attachment, key => $value...) 90=item $map->attach ($attachment, key => $value...)
123 91
124=item $map->detach ($attachment) 92=item $map->detach ($attachment)
125 93
126Attach/detach a pre-registered attachment to a map. 94Attach/detach a pre-registered attachment to a map.
95
96=item $bool = $object->attached ($name)
97
98=item $bool = $player->attached ($name)
99
100=item $bool = $map->attached ($name)
101
102Checks wether the named attachment is currently attached to the object.
127 103
128=item cf::attach_global ... 104=item cf::attach_global ...
129 105
130Attach handlers for global events. 106Attach handlers for global events.
131 107
181Attach handlers to all maps. 157Attach handlers to all maps.
182 158
183=item cf:register_attachment $name, ... 159=item cf:register_attachment $name, ...
184 160
185Register an attachment by name through which objects can refer to this 161Register an attachment by name through which objects can refer to this
162attachment.
163
164=item cf:register_player_attachment $name, ...
165
166Register an attachment by name through which players can refer to this
186attachment. 167attachment.
187 168
188=item cf:register_map_attachment $name, ... 169=item cf:register_map_attachment $name, ...
189 170
190Register an attachment by name through which maps can refer to this 171Register an attachment by name through which maps can refer to this
261} 242}
262 243
263sub _attach_attachment { 244sub _attach_attachment {
264 my ($obj, $name, %arg) = @_; 245 my ($obj, $name, %arg) = @_;
265 246
247 return if exists $obj->{_attachment}{$name};
248
266 my $res; 249 my $res;
267 250
268 if (my $attach = $attachment{$name}) { 251 if (my $attach = $attachment{$name}) {
269 my $registry = $obj->registry; 252 my $registry = $obj->registry;
270 253
282 265
283 $res->{attachment} = $name; 266 $res->{attachment} = $name;
284 $res 267 $res
285} 268}
286 269
287sub cf::object::attach { 270*cf::object::attach =
271*cf::player::attach =
272*cf::map::attach = sub {
288 my ($obj, $name, %arg) = @_; 273 my ($obj, $name, %arg) = @_;
289 274
290 _attach_attachment $obj, $name, %arg; 275 _attach_attachment $obj, $name, %arg;
291} 276};
292 277
293sub cf::player::attach { 278# all those should be optimised
294 my ($obj, $name, %arg) = @_;
295
296 _attach_attachment $obj, $name, %arg;
297}
298
299sub cf::map::attach {
300 my ($obj, $name, %arg) = @_;
301
302 _attach_attachment $obj, $name, %arg;
303}
304
305sub cf::object::detach { 279*cf::object::detach =
280*cf::player::detach =
281*cf::map::detach = sub {
306 my ($obj, $name) = @_; 282 my ($obj, $name) = @_;
307 die;#d# 283
308} 284 delete $obj->{_attachment}{$name};
309sub cf::player::detach { 285 reattach ($obj);
286};
287
288*cf::object::attached =
289*cf::player::attached =
290*cf::map::attached = sub {
310 my ($obj, $name) = @_; 291 my ($obj, $name) = @_;
311 die;#d# 292
312} 293 exists $obj->{_attachment}{$name}
313sub cf::map::detach { 294};
314 my ($obj, $name) = @_;
315 die;#d#
316}
317 295
318sub attach_global { 296sub attach_global {
319 _attach @CB_GLOBAL, KLASS_GLOBAL, @_ 297 _attach @CB_GLOBAL, KLASS_GLOBAL, @_
320} 298}
321 299
342 my $name = shift; 320 my $name = shift;
343 321
344 $attachment{$name} = [[KLASS_OBJECT, @_]]; 322 $attachment{$name} = [[KLASS_OBJECT, @_]];
345} 323}
346 324
325sub register_player_attachment {
326 my $name = shift;
327
328 $attachment{$name} = [[KLASS_PLAYER, @_]];
329}
330
347sub register_map_attachment { 331sub register_map_attachment {
348 my $name = shift; 332 my $name = shift;
349 333
350 $attachment{$name} = [[KLASS_MAP, @_]]; 334 $attachment{$name} = [[KLASS_MAP, @_]];
351} 335}
369 for (@$callbacks) { 353 for (@$callbacks) {
370 eval { &{$_->[1]} }; 354 eval { &{$_->[1]} };
371 355
372 if ($@) { 356 if ($@) {
373 warn "$@"; 357 warn "$@";
374 warn "... while processing $EVENT[$event][0] event, skipping processing altogether.\n"; 358 warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
375 override; 359 override;
376 } 360 }
377 361
378 return 1 if $override; 362 return 1 if $override;
379 } 363 }
380 364
381 0 365 0
382} 366}
367
368=item $bool = cf::invoke EVENT_GLOBAL_XXX, ...
369
370=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...)
371
372=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...)
373
374=item $bool = $map->invoke (EVENT_MAP_XXX, ...)
375
376Generate a global/object/player/map-specific event with the given arguments.
377
378This API is preliminary (most likely, the EVENT_KLASS_xxx prefix will be
379removed in future versions), and there is no public API to access override
380results (if you must, access C<@cf::invoke_results> directly).
381
382=back
383
384=head2 methods valid for all pointers
385
386=over 4
387
388=item $object->valid
389
390=item $player->valid
391
392=item $map->valid
393
394Just because you have a perl object does not mean that the corresponding
395C-level object still exists. If you try to access an object that has no
396valid C counterpart anymore you get an exception at runtime. This method
397can be used to test for existence of the C object part without causing an
398exception.
399
400=back
401
402=cut
403
404*cf::object::valid =
405*cf::player::valid =
406*cf::map::valid = \&cf::_valid;
383 407
384############################################################################# 408#############################################################################
385# object support 409# object support
386 410
387sub instantiate { 411sub instantiate {
416 } 440 }
417 } 441 }
418} 442}
419 443
420sub object_freezer_save { 444sub object_freezer_save {
421 my ($filename, $objs) = @_; 445 my ($filename, $rdata, $objs) = @_;
422 446
423 if (@$objs) { 447 if (length $$rdata) {
448 warn sprintf "saving %s (%d,%d)\n",
449 $filename, length $$rdata, scalar @$objs;
450
424 open my $fh, ">:raw", "$filename.pst~"; 451 if (open my $fh, ">:raw", "$filename~") {
452 chmod SAVE_MODE, $fh;
453 syswrite $fh, $$rdata;
454 close $fh;
455
456 if (@$objs && open my $fh, ">:raw", "$filename.pst~") {
457 chmod SAVE_MODE, $fh;
425 syswrite $fh, Storable::nfreeze { version => 1, objs => $objs }; 458 syswrite $fh, Storable::nfreeze { version => 1, objs => $objs };
426 close $fh; 459 close $fh;
427 chmod SAVE_MODE, "$filename.pst~";
428 rename "$filename.pst~", "$filename.pst"; 460 rename "$filename.pst~", "$filename.pst";
461 } else {
462 unlink "$filename.pst";
463 }
464
465 rename "$filename~", $filename;
466 } else {
467 warn "FATAL: $filename~: $!\n";
468 }
429 } else { 469 } else {
470 unlink $filename;
430 unlink "$filename.pst"; 471 unlink "$filename.pst";
431 } 472 }
432
433 chmod SAVE_MODE, "$filename~";
434 rename "$filename~", $filename;
435} 473}
436 474
437sub object_thawer_load { 475sub object_thawer_load {
438 my ($filename) = @_; 476 my ($filename) = @_;
439 477
478 local $/;
479
480 my $av;
481
482 #TODO: use sysread etc.
483 if (open my $data, "<:raw:perlio", $filename) {
484 $data = <$data>;
440 open my $fh, "<:raw:perlio", "$filename.pst" 485 if (open my $pst, "<:raw:perlio", "$filename.pst") {
441 or return; 486 $av = eval { (Storable::thaw <$pst>)->{objs} };
487 }
488 return ($data, $av);
489 }
442 490
443 eval { local $/; (Storable::thaw <$fh>)->{objs} } 491 ()
444} 492}
445 493
446attach_to_objects 494attach_to_objects
447 prio => -1000000, 495 prio => -1000000,
448 on_clone => sub { 496 on_clone => sub {
594 load_extension $ext; 642 load_extension $ext;
595 1 643 1
596 } or warn "$ext not loaded: $@"; 644 } or warn "$ext not loaded: $@";
597 } 645 }
598} 646}
599
600sub _perl_reload(&) {
601 my ($msg) = @_;
602
603 $msg->("reloading...");
604
605 eval {
606 # 1. cancel all watchers
607 $_->cancel for Event::all_watchers;
608
609 # 2. unload all extensions
610 for (@exts) {
611 $msg->("unloading <$_>");
612 unload_extension $_;
613 }
614
615 # 3. unload all modules loaded from $LIBDIR
616 while (my ($k, $v) = each %INC) {
617 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
618
619 $msg->("removing <$k>");
620 delete $INC{$k};
621
622 $k =~ s/\.pm$//;
623 $k =~ s/\//::/g;
624
625 if (my $cb = $k->can ("unload_module")) {
626 $cb->();
627 }
628
629 Symbol::delete_package $k;
630 }
631
632 # 4. get rid of safe::, as good as possible
633 Symbol::delete_package "safe::$_"
634 for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);
635
636 # 5. remove register_script_function callbacks
637 # TODO
638
639 # 6. unload cf.pm "a bit"
640 delete $INC{"cf.pm"};
641
642 # don't, removes xs symbols, too,
643 # and global variables created in xs
644 #Symbol::delete_package __PACKAGE__;
645
646 # 7. reload cf.pm
647 $msg->("reloading cf.pm");
648 require cf;
649 };
650 $msg->($@) if $@;
651
652 $msg->("reloaded");
653};
654
655sub perl_reload() {
656 _perl_reload {
657 warn $_[0];
658 print "$_[0]\n";
659 };
660}
661
662register_command "perl-reload", 0, sub {
663 my ($who, $arg) = @_;
664
665 if ($who->flag (FLAG_WIZ)) {
666 _perl_reload {
667 warn $_[0];
668 $who->message ($_[0]);
669 };
670 }
671};
672 647
673############################################################################# 648#############################################################################
674# extcmd framework, basically convert ext <msg> 649# extcmd framework, basically convert ext <msg>
675# into pkg::->on_extcmd_arg1 (...) while shortcutting a few 650# into pkg::->on_extcmd_arg1 (...) while shortcutting a few
676 651
704 defined $path or return; 679 defined $path or return;
705 680
706 unlink "$path.pst"; 681 unlink "$path.pst";
707}; 682};
708 683
709# old style persistent data, TODO: remove #d#
710*cf::mapsupport::on_swapin =
711*cf::mapsupport::on_load = sub {
712 my ($map) = @_;
713
714 my $path = $map->tmpname;
715 $path = $map->path unless defined $path;
716
717 open my $fh, "<:raw", "$path.cfperl"
718 or return; # no perl data
719
720 my $data = Storable::thaw do { local $/; <$fh> };
721
722 $data->{version} <= 1
723 or return; # too new
724
725 $map->_set_obs ($data->{obs});
726 $map->invoke (EVENT_MAP_UPGRADE);
727};
728
729attach_to_maps prio => -10000, package => cf::mapsupport::; 684attach_to_maps prio => -10000, package => cf::mapsupport::;
730 685
731############################################################################# 686#############################################################################
732# load/save perl data associated with player->ob objects 687# load/save perl data associated with player->ob objects
733 688
734sub all_objects(@) { 689sub all_objects(@) {
735 @_, map all_objects ($_->inv), @_ 690 @_, map all_objects ($_->inv), @_
736} 691}
737 692
693# TODO: compatibility cruft, remove when no longer needed
738attach_to_players 694attach_to_players
739 on_load => sub { 695 on_load => sub {
740 my ($pl, $path) = @_; 696 my ($pl, $path) = @_;
741 697
742 for my $o (all_objects $pl->ob) { 698 for my $o (all_objects $pl->ob) {
852 } 808 }
853 809
854 wantarray ? @res : $res[0] 810 wantarray ? @res : $res[0]
855} 811}
856 812
813=item cf::register_script_function $function => $cb
814
815Register a function that can be called from within map/npc scripts. The
816function should be reasonably secure and should be put into a package name
817like the extension.
818
819Example: register a function that gets called whenever a map script calls
820C<rent::overview>, as used by the C<rent> extension.
821
822 cf::register_script_function "rent::overview" => sub {
823 ...
824 };
825
826=cut
827
857sub register_script_function { 828sub register_script_function {
858 my ($fun, $cb) = @_; 829 my ($fun, $cb) = @_;
859 830
860 no strict 'refs'; 831 no strict 'refs';
861 *{"safe::$fun"} = $safe_hole->wrap ($cb); 832 *{"safe::$fun"} = $safe_hole->wrap ($cb);
862} 833}
863 834
864############################################################################# 835#############################################################################
836
837=head2 EXTENSION DATABASE SUPPORT
838
839Crossfire maintains a very simple database for extension use. It can
840currently store anything that can be serialised using Storable, which
841excludes objects.
842
843The parameter C<$family> should best start with the name of the extension
844using it, it should be unique.
845
846=over 4
847
848=item $hashref = cf::db_get $family
849
850Return a hashref for use by the extension C<$family>, which can be
851modified. After modifications, you have to call C<cf::db_dirty> or
852C<cf::db_sync>.
853
854=item $value = cf::db_get $family => $key
855
856Returns a single value from the database
857
858=item cf::db_put $family => $hashref
859
860Stores the given family hashref into the database. Updates are delayed, if
861you want the data to be synced to disk immediately, use C<cf::db_sync>.
862
863=item cf::db_put $family => $key => $value
864
865Stores the given C<$value> in the family hash. Updates are delayed, if you
866want the data to be synced to disk immediately, use C<cf::db_sync>.
867
868=item cf::db_dirty
869
870Marks the database as dirty, to be updated at a later time.
871
872=item cf::db_sync
873
874Immediately write the database to disk I<if it is dirty>.
875
876=cut
877
878{
879 my $db;
880 my $path = cf::localdir . "/database.pst";
881
882 sub db_load() {
883 warn "loading database $path\n";#d# remove later
884 $db = stat $path ? Storable::retrieve $path : { };
885 }
886
887 my $pid;
888
889 sub db_save() {
890 warn "saving database $path\n";#d# remove later
891 waitpid $pid, 0 if $pid;
892 if (0 == ($pid = fork)) {
893 $db->{_meta}{version} = 1;
894 Storable::nstore $db, "$path~";
895 rename "$path~", $path;
896 cf::_exit 0 if defined $pid;
897 }
898 }
899
900 my $dirty;
901
902 sub db_sync() {
903 db_save if $dirty;
904 undef $dirty;
905 }
906
907 my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, cb => sub {
908 db_sync;
909 });
910
911 sub db_dirty() {
912 $dirty = 1;
913 $idle->start;
914 }
915
916 sub db_get($;$) {
917 @_ >= 2
918 ? $db->{$_[0]}{$_[1]}
919 : ($db->{$_[0]} ||= { })
920 }
921
922 sub db_put($$;$) {
923 if (@_ >= 3) {
924 $db->{$_[0]}{$_[1]} = $_[2];
925 } else {
926 $db->{$_[0]} = $_[1];
927 }
928 db_dirty;
929 }
930
931 attach_global
932 prio => 10000,
933 on_cleanup => sub {
934 db_sync;
935 },
936 ;
937}
938
939#############################################################################
865# the server's main() 940# the server's main()
866 941
867sub main { 942sub main {
943 db_load;
944 load_extensions;
868 Event::loop; 945 Event::loop;
869} 946}
870 947
871############################################################################# 948#############################################################################
872# initialisation 949# initialisation
873 950
951sub _perl_reload(&) {
952 my ($msg) = @_;
953
954 $msg->("reloading...");
955
956 eval {
957 # cancel all watchers
958 $_->cancel for Event::all_watchers;
959
960 # unload all extensions
961 for (@exts) {
962 $msg->("unloading <$_>");
963 unload_extension $_;
964 }
965
966 # unload all modules loaded from $LIBDIR
967 while (my ($k, $v) = each %INC) {
968 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
969
970 $msg->("removing <$k>");
971 delete $INC{$k};
972
973 $k =~ s/\.pm$//;
974 $k =~ s/\//::/g;
975
976 if (my $cb = $k->can ("unload_module")) {
977 $cb->();
978 }
979
980 Symbol::delete_package $k;
981 }
982
983 # sync database to disk
984 cf::db_sync;
985
986 # get rid of safe::, as good as possible
987 Symbol::delete_package "safe::$_"
988 for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);
989
990 # remove register_script_function callbacks
991 # TODO
992
993 # unload cf.pm "a bit"
994 delete $INC{"cf.pm"};
995
996 # don't, removes xs symbols, too,
997 # and global variables created in xs
998 #Symbol::delete_package __PACKAGE__;
999
1000 # reload cf.pm
1001 $msg->("reloading cf.pm");
1002 require cf;
1003
1004 # load database again
1005 cf::db_load;
1006
1007 # load extensions
1008 $msg->("load extensions");
1009 cf::load_extensions;
1010
1011 # reattach attachments to objects
1012 $msg->("reattach");
1013 _global_reattach;
1014 };
1015 $msg->($@) if $@;
1016
1017 $msg->("reloaded");
1018};
1019
1020sub perl_reload() {
1021 _perl_reload {
1022 warn $_[0];
1023 print "$_[0]\n";
1024 };
1025}
1026
1027register_command "perl-reload", 0, sub {
1028 my ($who, $arg) = @_;
1029
1030 if ($who->flag (FLAG_WIZ)) {
1031 _perl_reload {
1032 warn $_[0];
1033 $who->message ($_[0]);
1034 };
1035 }
1036};
1037
874register "<global>", __PACKAGE__; 1038register "<global>", __PACKAGE__;
875 1039
876unshift @INC, $LIBDIR; 1040unshift @INC, $LIBDIR;
877
878load_extensions;
879 1041
880$TICK_WATCHER = Event->timer ( 1042$TICK_WATCHER = Event->timer (
881 prio => 1, 1043 prio => 1,
882 at => $NEXT_TICK || 1, 1044 at => $NEXT_TICK || 1,
883 cb => sub { 1045 cb => sub {
892 $TICK_WATCHER->at ($NEXT_TICK); 1054 $TICK_WATCHER->at ($NEXT_TICK);
893 $TICK_WATCHER->start; 1055 $TICK_WATCHER->start;
894 }, 1056 },
895); 1057);
896 1058
897_reload_2;
898
8991 10591
900 1060

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines