don't include 'collated' relationships in viewer
[scpubgit/stemmatology.git] / stemmaweb / lib / stemmaweb / Controller / Relation.pm
CommitLineData
5c9ecf66 1package stemmaweb::Controller::Relation;
2376359f 2use Moose;
3use namespace::autoclean;
581aee24 4use TryCatch;
2376359f 5
6BEGIN { extends 'Catalyst::Controller' }
7
8
9=head1 NAME
10
5c9ecf66 11stemmaweb::Controller::Relation - Controller for the relationship mapper
2376359f 12
13=head1 DESCRIPTION
14
581aee24 15The reading relationship mapper with draggable nodes.
2376359f 16
17=head1 METHODS
18
581aee24 19=head2 index
20
2376359f 21 GET relation/$textid
22
23Renders the application for the text identified by $textid.
24
2376359f 25=cut
26
72874569 27sub index :Path :Args(0) {
28 my( $self, $c ) = @_;
581aee24 29 $c->stash->{'template'} = 'relate.tt';
30}
31
9ca77245 32=head2 help
33
34 GET relation/help
35
36Returns the help window HTML.
37
38=cut
39
40sub help :Local :Args(0) {
41 my( $self, $c ) = @_;
42 $c->stash->{'template'} = 'relatehelp.tt';
43}
44
72874569 45=head2 definitions
581aee24 46
1c0900ef 47 GET relation/definitions
581aee24 48
49Returns a data structure giving the valid types and scopes for a relationship.
50
51=cut
52
1c0900ef 53sub definitions :Local :Args(0) {
581aee24 54 my( $self, $c ) = @_;
72874569 55 my $valid_relationships = [ qw/ spelling orthographic grammatical meaning
56 lexical transposition / ];
581aee24 57 my $valid_scopes = [ qw/ local global / ];
58 $c->stash->{'result'} = { 'types' => $valid_relationships, 'scopes' => $valid_scopes };
59 $c->forward('View::JSON');
2376359f 60}
61
72874569 62=head2 text
581aee24 63
72874569 64 GET relation/$textid/
65
66 Runs the relationship mapper for the specified text ID.
67
581aee24 68=cut
69
72874569 70sub text :Chained('/') :PathPart('relation') :CaptureArgs(1) {
71 my( $self, $c, $textid ) = @_;
72 $c->stash->{'tradition'} = $c->model('Directory')->tradition( $textid );
73}
74
75sub main :Chained('text') :PathPart('') :Args(0) {
581aee24 76 my( $self, $c ) = @_;
1c0900ef 77 my $tradition = delete $c->stash->{'tradition'};
78 my $collation = $tradition->collation;
72874569 79 my $svg_str = $collation->as_svg;
80 $svg_str =~ s/\n//gs;
81 $c->stash->{'svg_string'} = $svg_str;
82 $c->stash->{'text_title'} = $tradition->name;
83 $c->stash->{'template'} = 'relate.tt';
84
581aee24 85}
86
87=head2 relationships
88
72874569 89 GET $textid/relationships
90
91Returns the list of relationships defined for this text.
581aee24 92
72874569 93 POST $textid/relationships { request }
94
95Attempts to define the requested relationship within the text. Returns 200 on
96success or 403 on error.
581aee24 97
72874569 98 DELETE $textid/relationships { request }
99
581aee24 100
101=cut
102
72874569 103sub relationships :Chained('text') :PathPart :Args(0) {
581aee24 104 my( $self, $c ) = @_;
bff7bb42 105 my $tradition = delete $c->stash->{'tradition'};
106 my $collation = $tradition->collation;
7c280843 107 my $m = $c->model('Directory');
72874569 108 if( $c->request->method eq 'GET' ) {
109 my @pairs = $collation->relationships; # returns the edges
110 my @all_relations;
111 foreach my $p ( @pairs ) {
112 my $relobj = $collation->relations->get_relationship( @$p );
9251a7be 113 next if $relobj->type eq 'collated'; # Don't show these
31aaf446 114 my $relhash = { source => $p->[0], target => $p->[1],
115 type => $relobj->type, scope => $relobj->scope };
116 $relhash->{'note'} = $relobj->annotation if $relobj->has_annotation;
117 push( @all_relations, $relhash );
72874569 118 }
119 $c->stash->{'result'} = \@all_relations;
120 } elsif( $c->request->method eq 'POST' ) {
121 my $node = $c->request->param('source_id');
122 my $target = $c->request->param('target_id');
123 my $relation = $c->request->param('rel_type');
124 my $note = $c->request->param('note');
125 my $scope = $c->request->param('scope');
126
127 my $opts = { 'type' => $relation,
31aaf446 128 'scope' => $scope };
129 $opts->{'annotation'} = $note if $note;
72874569 130
131 try {
132 my @vectors = $collation->add_relationship( $node, $target, $opts );
133 $c->stash->{'result'} = \@vectors;
7c280843 134 $m->save( $tradition );
72874569 135 } catch( Text::Tradition::Error $e ) {
136 $c->response->status( '403' );
137 $c->stash->{'result'} = { 'error' => $e->message };
138 }
139 } elsif( $c->request->method eq 'DELETE' ) {
140 my $node = $c->request->param('source_id');
141 my $target = $c->request->param('target_id');
142
143 try {
144 my @vectors = $collation->del_relationship( $node, $target );
7c280843 145 $m->save( $tradition );
72874569 146 $c->stash->{'result'} = \@vectors;
147 } catch( Text::Tradition::Error $e ) {
148 $c->response->status( '403' );
149 $c->stash->{'result'} = { 'error' => $e->message };
150 }
581aee24 151 }
581aee24 152 $c->forward('View::JSON');
153}
72874569 154
581aee24 155
2376359f 156=head2 end
157
158Attempt to render a view, if needed.
159
160=cut
161
162sub end : ActionClass('RenderView') {}
163
164=head1 AUTHOR
165
166Tara L Andrews
167
168=head1 LICENSE
169
170This library is free software. You can redistribute it and/or modify
171it under the same terms as Perl itself.
172
173=cut
174
175__PACKAGE__->meta->make_immutable;
176
1771;