Bio/Biblio/MedlineJournal.pm

   1 # $Id$
   2 #
   3 # BioPerl module for Bio::Biblio::MedlineJournal
   4 #
   5 # Cared for by Martin Senger <senger@ebi.ac.uk>
   6 # For copyright and disclaimer see below.
   7
   8 # POD documentation - main docs before the code
   9
  10 =head1 NAME
  11
  12 Bio::Biblio::MedlineJournal - Representation of a MEDLINE journal
  13
  14 =head1 SYNOPSIS
  15
  16     $obj = new Bio::Biblio::MedlineJournal
  17                (-medline_ta => 'J Vasc Interv Radiol');
  18  --- OR ---
  19
  20     $obj = new Bio::Biblio::MedlineJournal;
  21     $obj->medline_ta ('J Vasc Interv Radiol');
  22
  23 =head1 DESCRIPTION
  24
  25 A storage object for a MEDLINE journal.
  26 See its place in the class hierarchy in
  27 http://industry.ebi.ac.uk/openBQS/images/bibobjects_perl.gif
  28
  29 =head2 Attributes
  30
  31 The following attributes are specific to this class
  32 (however, you can also set and get all attributes defined in the parent classes):
  33
  34   coden
  35   country
  36   medline_code
  37   medline_ta
  38   nlm_unique_id
  39
  40 =head1 SEE ALSO
  41
  42 =over
  43
  44 =item *
  45
  46 OpenBQS home page: http://industry.ebi.ac.uk/openBQS
  47
  48 =item *
  49
  50 Comments to the Perl client: http://industry.ebi.ac.uk/openBQS/Client_perl.html
  51
  52 =back
  53
  54 =head1 FEEDBACK
  55
  56 =head2 Mailing Lists
  57
  58 User feedback is an integral part of the evolution of this and other
  59 Bioperl modules. Send your comments and suggestions preferably to
  60 the Bioperl mailing list.  Your participation is much appreciated.
  61
  62   bioperl-l@bioperl.org              - General discussion
  63   http://bioperl.org/MailList.shtml  - About the mailing lists
  64
  65 =head2 Reporting Bugs
  66
  67 Report bugs to the Bioperl bug tracking system to help us keep track
  68 of the bugs and their resolution. Bug reports can be submitted via
  69 email or the web:
  70
  71   bioperl-bugs@bioperl.org
  72   http://bugzilla.bioperl.org/
  73
  74 =head1 AUTHORS
  75
  76 Heikki Lehvaslaiho (heikki@ebi.ac.uk),
  77 Martin Senger (senger@ebi.ac.uk)
  78
  79 =head1 COPYRIGHT
  80
  81 Copyright (c) 2002 European Bioinformatics Institute. All Rights Reserved.
  82
  83 This module is free software; you can redistribute it and/or modify
  84 it under the same terms as Perl itself.
  85
  86 =head1 DISCLAIMER
  87
  88 This software is provided "as is" without warranty of any kind.
  89
  90 =cut
  91
  92
  93 # Let the code begin...
  94
  95 package Bio::Biblio::MedlineJournal;
  96 use strict;
  97 use vars qw(@ISA);
  98
  99 use Bio::Biblio::Journal;
 100
 101 @ISA = qw(Bio::Biblio::Journal);
 102
 103 #
 104 # a closure with a list of allowed attribute names (these names
 105 # correspond with the allowed 'get' and 'set' methods); each name also
 106 # keep what type the attribute should be (use 'undef' if it is a
 107 # simple scalar)
 108 #
 109 {
 110     my %_allowed =
 111         (
 112          _coden => undef,
 113          _country => undef,
 114          _medline_code => undef,
 115          _medline_ta => undef,
 116          _nlm_unique_id => undef,
 117          );
 118
 119     # return 1 if $attr is allowed to be set/get in this class
 120     sub _accessible {
 121         my ($self, $attr) = @_;
 122         exists $_allowed{$attr} or $self->SUPER::_accessible ($attr);
 123     }
 124
 125     # return an expected type of given $attr
 126     sub _attr_type {
 127         my ($self, $attr) = @_;
 128         if (exists $_allowed{$attr}) {
 129             return $_allowed{$attr};
 130         } else {
 131             return $self->SUPER::_attr_type ($attr);
 132         }
 133     }
 134 }
 135
 136 1;
 137 __END__