Gridarta Editor
SuspiciousMsgChecker.java
Go to the documentation of this file.
1 /*
2  * Gridarta MMORPG map editor for Crossfire, Daimonin and similar games.
3  * Copyright (C) 2000-2023 The Gridarta Developers.
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 2 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License along
16  * with this program; if not, write to the Free Software Foundation, Inc.,
17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
18  */
19 
20 package net.sf.gridarta.var.crossfire.model.validation.checks;
21 
22 import java.util.Collections;
23 import java.util.regex.Matcher;
24 import java.util.regex.Pattern;
33 import org.jetbrains.annotations.NotNull;
34 
40 public class SuspiciousMsgChecker<G extends GameObject<G, A, R>, A extends MapArchObject<A>, R extends Archetype<G, A, R>> extends AbstractValidator<G, A, R> implements GameObjectValidator<G, A, R> {
41 
45  @NotNull
46  private static final Pattern PATTERN_REPLY = Pattern.compile("(@reply|@question)([ ]+)([^ ]+)([ ]+)(.+)");
47 
51  @NotNull
52  private static final Pattern PATTERN_REPLY_WITHOUT_TEXT = Pattern.compile("(@reply|@question)[ ]+([^ ]+)");
53 
57  @NotNull
58  private final RegExParser parser = new RegExParser();
59 
63  @NotNull
65 
69  @NotNull
71 
75  @NotNull
77 
81  @NotNull
83 
89  super(validatorPreferences);
90  }
91 
92  @Override
93  public void validateGameObject(@NotNull final G gameObject, @NotNull final ErrorCollector<G, A, R> errorCollector) {
94  final String msg = gameObject.getMsgText(true);
95  switch (gameObject.getTypeNo()) {
97  if (msg == null || msg.isEmpty()) {
98  errorCollector.collect(new SuspiciousMsgMagicEarWithoutMessageError<>(gameObject));
99  } else {
100  checkMessage(gameObject, errorCollector, msg, true);
101  }
102  break;
103 
104  default:
105  if (msg != null) {
106  for (final String line : msg.split("\n")) {
107  if (line.startsWith("@") || line.startsWith("match")) {
108  checkMessage(gameObject, errorCollector, msg, false);
109  break;
110  }
111  }
112  }
113  break;
114  }
115  }
116 
124  private void checkMessage(@NotNull final G gameObject, @NotNull final ErrorCollector<G, A, R> errorCollector, @NotNull final String msg, final boolean magicEar) {
125  if (!msg.isEmpty() && !msg.endsWith("\n")) {
126  throw new IllegalArgumentException("message does not end with \\n: " + msg);
127  }
132 
133  final ErrorGenerator<G, A, R> generator = new ErrorGenerator<>(errorCollector, gameObject);
134 
135  if (!msg.isEmpty()) {
136  for (final String line : msg.substring(0, msg.length() - 1).split("\n", -1)) {
137  generator.setCurrentLine(line);
138  if (line.startsWith("@match ")) {
139  final String text = line.substring(7);
140  if (text.equals("*")) {
141  keywordValidator.match(generator, Collections.singleton("*"));
142  } else if (text.startsWith("*")) {
143  generator.errorMatchAllText();
144  keywordValidator.match(generator, Collections.singleton("*"));
145  } else {
146  parser.parse(text, generator);
147  keywordValidator.match(generator, parser.getWords());
148  }
149 
150  if (magicEar) {
151  magicEarValidator.match(generator);
152  } else {
154  textValidator.match(generator);
155  }
156  } else if (line.equals("@match")) {
157  generator.errorSyntaxError("missing keywords after '@match'");
158  if (magicEar) {
159  magicEarValidator.match(generator);
160  } else {
162  textValidator.match(generator);
163  }
164  } else {
165  final Matcher matcher = PATTERN_REPLY.matcher(line);
166  if (matcher.matches()) {
167  final String keyword = matcher.group(1);
168  if (matcher.group(2).length() > 1) {
169  generator.errorKeywordError("the keyword '" + matcher.group(2).substring(1) + matcher.group(3) + "' after '" + keyword + "' starts with a space");
170  }
171  if (matcher.group(4).length() > 1) {
172  generator.errorKeywordError("the text '" + matcher.group(4).substring(1) + matcher.group(5) + "' after '" + keyword + "' starts with a space");
173  }
174  if (magicEar) {
175  magicEarValidator.reply(generator);
176  } else {
177  replyValidator.reply(generator);
178  textValidator.reply(generator);
179  }
180  keywordValidator.reply(generator, matcher.group(1), matcher.group(3));
181  } else {
182  final Matcher matcher2 = PATTERN_REPLY_WITHOUT_TEXT.matcher(line);
183  if (matcher2.matches()) {
184  final String keyword = matcher2.group(1);
185  generator.errorSyntaxError("missing text after '" + keyword + "'");
186  if (magicEar) {
187  magicEarValidator.reply(generator);
188  } else {
189  replyValidator.reply(generator);
190  textValidator.reply(generator);
191  }
192  keywordValidator.reply(generator, keyword, matcher2.group(2));
193  } else if (line.equals("@reply")) {
194  generator.errorSyntaxError("missing keyword after '@reply'");
195  if (magicEar) {
196  magicEarValidator.reply(generator);
197  } else {
198  replyValidator.reply(generator);
199  textValidator.reply(generator);
200  }
201  } else if (line.equals("@question")) {
202  generator.errorSyntaxError("missing keyword after '@question'");
203  if (magicEar) {
204  magicEarValidator.reply(generator);
205  } else {
206  replyValidator.reply(generator);
207  textValidator.reply(generator);
208  }
209  } else {
210  if (!magicEar) {
211  replyValidator.text(generator);
212  }
213  if (line.isEmpty()) {
214  if (magicEar) {
215  magicEarValidator.empty(generator);
216  } else {
217  textValidator.empty(generator);
218  }
219  } else {
220  if (line.startsWith("match")) {
221  generator.errorSyntaxError("a text line starts with 'match'. Maybe '@match' was intended?");
222  } else if (line.startsWith("@")) {
223  generator.errorSyntaxError("unrecognized keyword: '" + line + "'");
224  }
225  if (magicEar) {
226  magicEarValidator.text(generator);
227  } else {
228  textValidator.text(generator);
229  }
230  }
231  }
232  }
233  }
234  }
235  }
236 
237  if (magicEar) {
238  magicEarValidator.eof(generator);
239  } else {
240  textValidator.eof(generator);
241  }
242  keywordValidator.eof(generator);
243  }
244 
245 }
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker
A GameObjectValidator that checks for "msg" values that start with "match ".
Definition: SuspiciousMsgChecker.java:40
net.sf.gridarta.var.crossfire.model.validation.checks.KeywordValidator.match
void match(@NotNull final ErrorGenerator< G, A, R > generator, @NotNull final Iterable< String > matchKeywords)
Processes a @match line.
Definition: KeywordValidator.java:103
net.sf.gridarta.var.crossfire.model.validation.checks.ErrorGenerator.errorMatchAllText
void errorMatchAllText()
Adds a new error message for an '@match *' line with text following the '*'.
Definition: ErrorGenerator.java:92
net.sf.gridarta.var.crossfire.model.validation.checks.ReplyValidator.reply
void reply(@NotNull final ErrorGenerator< G, A, R > generator)
Processes a qreply or @question line.
Definition: ReplyValidator.java:129
net.sf.gridarta.var.crossfire.model.validation.checks.ReplyValidator.text
void text(@NotNull final ErrorGenerator< G, A, R > generator)
Processes a line of text.
Definition: ReplyValidator.java:75
net.sf.gridarta.var.crossfire.model.validation.checks.ErrorGenerator
Generator for SuspiciousMsgChecker related error messages.
Definition: ErrorGenerator.java:38
net.sf.gridarta.var.crossfire.model.archetype
Definition: Archetype.java:20
net.sf.gridarta
Base package of all Gridarta classes.
net.sf.gridarta.var.crossfire.model.validation.checks.MagicEarValidator.match
void match(@NotNull final ErrorGenerator< G, A, R > generator)
Processes a @match line.
Definition: MagicEarValidator.java:147
net.sf.gridarta.var.crossfire.model.validation.checks.MagicEarValidator< G, A, R >
net.sf
net.sf.gridarta.var.crossfire.model.archetype.Archetype.TYPE_MAGIC_EAR
int TYPE_MAGIC_EAR
Definition: Archetype.java:50
net.sf.gridarta.var.crossfire.model.validation.checks.TextValidator.eof
void eof(@NotNull final ErrorGenerator< G, A, R > generator)
Will be called at the end of processing.
Definition: TextValidator.java:208
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.SuspiciousMsgChecker
SuspiciousMsgChecker(@NotNull final ValidatorPreferences validatorPreferences)
Creates a new instance.
Definition: SuspiciousMsgChecker.java:88
net.sf.gridarta.var.crossfire.model.validation.checks.KeywordValidator.reply
void reply(@NotNull final ErrorGenerator< G, A, R > generator, @NotNull final String command, @NotNull final String keyword)
Processes a @reply or @question line.
Definition: KeywordValidator.java:133
net.sf.gridarta.var.crossfire.model.validation.checks.MagicEarValidator.eof
void eof(@NotNull final ErrorGenerator< G, A, R > generator)
Will be called at the end of processing.
Definition: MagicEarValidator.java:194
net.sf.gridarta.var.crossfire.model.validation.checks.TextValidator< G, A, R >
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.keywordValidator
final KeywordValidator< G, A, R > keywordValidator
The KeywordValidator instance.
Definition: SuspiciousMsgChecker.java:82
net.sf.gridarta.model.archetype
Definition: AbstractArchetype.java:20
net.sf.gridarta.var.crossfire.model.validation.checks.RegExParser
Parser for Crossfire regular expressions.
Definition: RegExParser.java:33
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.textValidator
final TextValidator< G, A, R > textValidator
The TextValidator instance.
Definition: SuspiciousMsgChecker.java:70
net.sf.gridarta.model.gameobject.GameObject
Reflects a game object (object on a map).
Definition: GameObject.java:36
net.sf.gridarta.var
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.PATTERN_REPLY_WITHOUT_TEXT
static final Pattern PATTERN_REPLY_WITHOUT_TEXT
Matches a @reply or @question line which is missing the text part.
Definition: SuspiciousMsgChecker.java:52
net.sf.gridarta.var.crossfire.model.validation.checks.RegExParser.getWords
Collection< String > getWords()
Returns the words from the last call to ErrorGenerator).
Definition: RegExParser.java:227
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.PATTERN_REPLY
static final Pattern PATTERN_REPLY
Matches a @reply or @question line.
Definition: SuspiciousMsgChecker.java:46
net.sf.gridarta.var.crossfire.model.validation.checks.RegExParser.parse
void parse(@NotNull final String regEx, @NotNull final ErrorGenerator<?, ?, ?> generator)
Parses a regular expression.
Definition: RegExParser.java:53
net.sf.gridarta.model.validation.AbstractValidator.validatorPreferences
final ValidatorPreferences validatorPreferences
The ValidatorPreferences to use.
Definition: AbstractValidator.java:55
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.magicEarValidator
final MagicEarValidator< G, A, R > magicEarValidator
The MagicEarValidator instance.
Definition: SuspiciousMsgChecker.java:76
net.sf.gridarta.model.validation.ValidatorPreferences
Configuration parameters for Validators.
Definition: ValidatorPreferences.java:28
net.sf.gridarta.var.crossfire.model.validation.checks.KeywordValidator< G, A, R >
net.sf.gridarta.var.crossfire.model.validation.checks.TextValidator.text
void text(@NotNull final ErrorGenerator< G, A, R > generator)
Processes a non-empty line of text.
Definition: TextValidator.java:74
net.sf.gridarta.model.gameobject
GameObjects are the objects based on Archetypes found on maps.
Definition: AbstractGameObject.java:20
net
net.sf.gridarta.var.crossfire.model.archetype.Archetype
Implements Crossfire archetypes.
Definition: Archetype.java:30
net.sf.gridarta.var.crossfire.model.maparchobject.MapArchObject
MapArchObject contains the specific meta data about a map that is stored in the map-arch,...
Definition: MapArchObject.java:39
net.sf.gridarta.var.crossfire.model.validation.checks.MagicEarValidator.reply
void reply(@NotNull final ErrorGenerator< G, A, R > generator)
Processes a qreply or @question line.
Definition: MagicEarValidator.java:182
net.sf.gridarta.var.crossfire.model.validation.checks.TextValidator.empty
void empty(@NotNull final ErrorGenerator< G, A, R > generator)
Processes an empty line of text.
Definition: TextValidator.java:108
net.sf.gridarta.var.crossfire
Main package of Gridarta4Crossfire, contains all classes specific to the Crossfire version of the Gri...
net.sf.gridarta.var.crossfire.model.validation.checks.TextValidator.match
void match(@NotNull final ErrorGenerator< G, A, R > generator)
Processes a @match line.
Definition: TextValidator.java:147
net.sf.gridarta.model.maparchobject.MapArchObject
Interface for MapArchObjects.
Definition: MapArchObject.java:40
net.sf.gridarta.var.crossfire.model.validation.checks.MagicEarValidator.text
void text(@NotNull final ErrorGenerator< G, A, R > generator)
Processes a non-empty line of text.
Definition: MagicEarValidator.java:74
net.sf.gridarta.var.crossfire.model.validation.checks.ErrorGenerator.errorSyntaxError
void errorSyntaxError(@NotNull final String reason)
Reports a general syntax error.
Definition: ErrorGenerator.java:100
net.sf.gridarta.var.crossfire.model
net.sf.gridarta.model.validation.ErrorCollector
An interface for classes that collect errors.
Definition: ErrorCollector.java:33
net.sf.gridarta.var.crossfire.model.validation.checks.TextValidator.reply
void reply(@NotNull final ErrorGenerator< G, A, R > generator)
Processes a qreply or @question line.
Definition: TextValidator.java:183
net.sf.gridarta.model.validation.AbstractValidator
This is the base class for validators.
Definition: AbstractValidator.java:37
net.sf.gridarta.model.validation
This package contains the framework for validating maps.
Definition: AbstractValidator.java:20
net.sf.gridarta.var.crossfire.model.validation.checks.ReplyValidator.match
void match()
Processes a @match line.
Definition: ReplyValidator.java:103
net.sf.gridarta.var.crossfire.model.validation.checks.MagicEarValidator.empty
void empty(@NotNull final ErrorGenerator< G, A, R > generator)
Processes an empty line of text.
Definition: MagicEarValidator.java:108
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.checkMessage
void checkMessage(@NotNull final G gameObject, @NotNull final ErrorCollector< G, A, R > errorCollector, @NotNull final String msg, final boolean magicEar)
Checks the "msg" field of a game object.
Definition: SuspiciousMsgChecker.java:124
net.sf.gridarta.var.crossfire.model.validation.checks.ReplyValidator< G, A, R >
net.sf.gridarta.var.crossfire.model.validation.checks.KeywordValidator.reset
void reset()
Resets the checker state.
Definition: KeywordValidator.java:88
net.sf.gridarta.model
net.sf.gridarta.model.archetype.Archetype
Reflects an Archetype.
Definition: Archetype.java:41
net.sf.gridarta.var.crossfire.model.validation.errors.SuspiciousMsgMagicEarWithoutMessageError
A magic ear that does not contain a @match line.
Definition: SuspiciousMsgMagicEarWithoutMessageError.java:33
net.sf.gridarta.var.crossfire.model.validation.checks.ErrorGenerator.errorKeywordError
void errorKeywordError(@NotNull final String reason)
Reports a keyword related error.
Definition: ErrorGenerator.java:108
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.parser
final RegExParser parser
The RegExParser instance.
Definition: SuspiciousMsgChecker.java:58
net.sf.gridarta.var.crossfire.model.gameobject.GameObject
Handles the Crossfire GameObjects.
Definition: GameObject.java:41
net.sf.gridarta.model.validation.GameObjectValidator
Interface for GameObject Validators.
Definition: GameObjectValidator.java:32
net.sf.gridarta.model.maparchobject
Definition: AbstractMapArchObject.java:20
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.validateGameObject
void validateGameObject(@NotNull final G gameObject, @NotNull final ErrorCollector< G, A, R > errorCollector)
Validates a game object.
Definition: SuspiciousMsgChecker.java:93
net.sf.gridarta.var.crossfire.model.validation.checks.KeywordValidator.eof
void eof(@NotNull final ErrorGenerator< G, A, R > generator)
Will be called at the end of processing.
Definition: KeywordValidator.java:153
net.sf.gridarta.var.crossfire.model.validation.errors
Definition: AbstractSuspiciousMsgError.java:20
net.sf.gridarta.var.crossfire.model.validation.checks.SuspiciousMsgChecker.replyValidator
final ReplyValidator< G, A, R > replyValidator
The ReplyValidator instance.
Definition: SuspiciousMsgChecker.java:64
net.sf.gridarta.var.crossfire.model.validation.checks.ReplyValidator.reset
void reset()
Resets the checker state.
Definition: ReplyValidator.java:64
net.sf.gridarta.var.crossfire.model.validation
net.sf.gridarta.var.crossfire.model.validation.checks.MagicEarValidator.reset
void reset()
Resets the checker state.
Definition: MagicEarValidator.java:63
net.sf.gridarta.var.crossfire.model.validation.checks.ErrorGenerator.setCurrentLine
void setCurrentLine(@NotNull final String line)
Sets the line currently being analyzed.
Definition: ErrorGenerator.java:75
net.sf.gridarta.var.crossfire.model.validation.checks.TextValidator.reset
void reset()
Resets the checker state.
Definition: TextValidator.java:63