^[\040\t]*(?:\([^\\\x80-\xff\n\015()]*(?:(?:\\[^\x80-

\xff]|\([^\\\x80-\xff\n\015()]*(?:\\[^\x80-\xff][^\\\x80-

\xff\n\015()]*)*\))[^\\\x80-

\xff\n\015()]*)*\)[\040\t]*)*(?:(?:[^(\040)<>@,;:".\\\[\]\000-

\037\x80-\xff]+(?![^(\040)<>@,;:".\\\[\]\000-\037\x80-

\xff])|"[^\\\x80-\xff\n\015"]*(?:\\[^\x80-\xff][^\\\x80-

\xff\n\015"]*)*")[\040\t]*(?:\([^\\\x80-

\xff\n\015()]*(?:(?:\\[^\x80-\xff]|\([^\\\x80-

\xff\n\015()]*(?:\\[^\x80-\xff][^\\\x80-

… … … … …

\xff])|\[(?:[^\\\x80-\xff\n\015\[\]]|\\[^\x80-

\xff])*\])[\040\t]*(?:\([^\\\x80-\xff\n\015()]*(?:(?:\\[^\x80-

\xff]|\([^\\\x80-\xff\n\015()]*(?:\\[^\x80-\xff][^\\\x80-

\xff\n\015()]*)*\))[^\\\x80-\xff\n\015()]*)*\)[\040\t]*)*)*>)$

public String process(String aString) throws FilterException

{

// что такое правила – будет объяснено чуть позже, тут они

// инициализируются, потому что фильтр может быть использован

// повторно

initRules();

// проверим, что на вход получена корректная строка

if (aString == null || aString.length() == 0)

{

return "";

}

// инициализация

Source source = new Source(aString);

Result result = new Result();

// основной цикл длится, пока мы находимся «не в состоянии завершения»

while (!result.getLastRuleResult().

equals(RuleResult.FILTER_FINISHED_PROCESSING))

{

result.setLastRuleResult(RuleResult.CHAR_NOT_CHANGED);

// строка обработана полностью

if (source.isStringFinished())

{

break;

}

// перед каждой обработкой – происходит внутренняя инициализация

// так же проверяется, что нет зацикливания

try

{

source.prepare();

}

catch (FilterException e)

{

e.printStackTrace();

if (e.getCanContinue().equals(FilterException.CONTINUABLE))

{

source.addToPosition(1);

continue;

}

else if (e.getCanContinue().equals(FilterException.FATAL))

{

throw e;

}

}

// прогоняем правила, соответствующие текущему символу

processRules(source, result);

// если ни одно правило не было применено, то

// выполняем правило по умолчанию

if (result.getLastRuleResult().

equals(RuleResult.CHAR_NOT_CHANGED))

{

EMPTY_RULE.process(source, result, this);

}

else if (result.getLastRuleResult().equals(

RuleResult.FILTER_FINISHED_PROCESSING))

{

break;

}

}

// В процессе работы фильтра в строку включаются тэги (основное

// его предназначение – форматирование для вывода в HTML)

// В результате ошибок и неаккуратностей некоторые теги могут быть

// незакрыты. Следующий метод дополняет строку закрывающими

// тегами в корректном порядке.

result.appendEndAppendersInReverseOrder();

return result.getResult();

}

public class HellipRule extends AbstractRule

{

private static final char CHARACTER = '.';

private static final Character INITIATOR = new Character(CHARACTER);

public Character getInitiatorCharacter()

{

return INITIATOR;

}

public void process(Source aSource, Result aResult, IFilter aFilter)

{

// проверяем, что за текущей точкой будут еще две точки

if (StringUtils.isSymbol(aSource.getSource(),

aSource.getPosition() + 1, CHARACTER) &&

StringUtils.isSymbol(aSource.getSource(),

aSource.getPosition() + 2, CHARACTER))

{

// в результат выводим нужную строку

aResult.append("&hellip;");

// выставляем состояние автомату, чтобы он

// переходил к следующему символу

aResult.setLastRuleResult(RuleResult.CHAR_FINISHED_PROCESSING);

// перескакиваем обработку всех трех точек

aSource.addToPosition(3);

}

}

}

public void process(Source aSource, Result aResult, IFilter aFilter)

{

int nextPosition = aSource.getPosition() + 1;

// проверяется, что следующий символ – такой же, как и предыдущий

if (isSymbol(aSource.getSourceString(), nextPosition, getSymbol()))

{

// смотрим на текущее состояние правила, чтобы определить,

// создавать открывающий или закрывающий тег

if (getState().equals(DoubleCharacterState.STATE_OUT))

{

// открывающий тег

setState(DoubleCharacterState.STATE_IN);

aSource.addToPosition(2);

aResult.append(getPrefix());

// записываем в «строки окончаний» закрывающий тег, который

// является парным к текущему – чтобы автоматически

// закрыть тег в конце строки, если не окажется

// парного к тому, который сейчас вставляется (1)

aResult.addEndAppend(getPostfix());

// устанавливаем состояние «окончания обработки символа»

aResult.setLastRuleResult(RuleResult.CHAR_FINISHED_PROCESSING);

}

else if (getState().equals(DoubleCharacterState.STATE_IN))

{

if (aResult.containsEndAppend(getPostfix()))

{

setState(DoubleCharacterState.STATE_OUT);

aSource.addToPosition(2);

aResult.append(getPostfix());

// удаляем закрывающий тег из «строк окончаний».

// Если бы мы его тут не удалили, после окончания

// обработки строки, он бы вставился автоматически.

aResult.removeEndAppend(getPostfix());

// устанавливаем состояние «окончания обработки символа»

aResult.

setLastRuleResult(RuleResult.CHAR_FINISHED_PROCESSING);

}

}

}

}

public interface IFilter extends Serializable

{

/**

* Обрабатывает строку, возвращая в качестве результата строку

* после фильтрации.

* @param aSourceString – исходная строка

* @return - обработанная строка

* @throws FilterException - если произошла фатальная ошибка

* (зацикливание)

*/

public String process(String aSourceString) throws FilterException;

/**

* Выключает правило по его rule.getClass().getName()

* @param aRuleClass – класс правила (что-то вроде IRule.class)

*/

public void disableRuleByClassName(Class aRuleClass);

/**

* Включает правило по его rule.getClass().getName()

* @param aRuleClass – класс правила (что-то вроде IRule.class)

*/

public void enableRuleByClassName(Class aRuleClass);

/**

* Включает все правила.

*/

public void enableAllRules();

/**

* Выключает все правила.

*/

public void disableAllRules();

/**

* Добавляет правило в фильтр.

* @param aRule правило, которое нужно добавить в фильтр.

*/

void addRule(IRule aRule);

}

public interface IRule extends Serializable

{

/**

* Метод, который вызывается перед обработкой произвольной строки.

*/

public void initialize();

/**

* Инициализация параметров правила. Этот метод используется в

* основном для установки параметров правила при загрузке

* конфигурации фильтра из XML.

* @param aParameters - карта параметров.

*/

void setParameters(Map aParameters) throws FilterException;

/**

* Включает или выключает правило.

*/

public void setEnabled(boolean aEnabled);

/**

* @return true, если правило включено, false – иначе.

*/

public boolean isEnabled();

/**

* @return - символ, который является инициатором данного правила.

*/

public Character getInitiatorCharacter();

/**

* Обрабатывает текущую строку при помощи правила.

* @param aSource - исходная строка, текущая позиция

* @param aResult - текущий результат обработки

* @param aFilter - текущий фильтр

*/

public void process(Source aSource, Result aResult, IFilter aFilter);

}

public interface IRuleGroup

{

/**

* Добавляет правила группы в указанный фильтр.

* @param aFilter

*/

public void addRules(IFilter aFilter);

/**

* Включает или выключает все правила, входящие в группу.

*/

public void setEnabled(boolean aEnabled);

/**

* Возвращает true, если все правила группы включены в указанном фильтре.

* @param aFilter

*/

public boolean isEnabled(IFilter aFilter);

/**

* Инициализация параметров группы. Этот метод используется в

* основном для установки параметров правила при загрузке

* конфигурации фильтра из XML.

* @param aParameters карта параметров

*/

public void setParameters(Map aParameters);

}

public class WikiFilter extends AbstractFilter

{

public WikiFilter(int aMaxWordLength, int aMaxStringLength)

{

// замена < на &lt;

addRule(new ReplaceLeftTagBracketRule());

// замена & на &amp;

addRule(new ReplaceAmpersandTagBracketRule());

// правило экранирования – для возможности вывода спецсимволов

addRule(new EkranRule());

// правило замены http://... - ссылками

addRule(new AnchoringRule(aMaxWordLength));

... ... ...

// правило разбивания длинных слов пробелами

addRule(new BreakWordsRule(aMaxWordLength));

// правило «обрезания» длинных строк

addRule(new MaxLengthRule(aMaxStringLength));

}

}

String result =

new WikiFilter(maxWordLength, maxStringLength).process(sourceString);

public abstract class AbstractRule implements IRule

{

// это поле сделано ThreadLocal для того, чтобы можно было одним фильтром

// обрабатывать несколько строк одновременно

private ThreadLocal _enabledThreadLocal = new ThreadLocal()

{

protected Object initialValue() {

// по умолчанию правило включается

return Boolean.TRUE;

}

};

public void setParameters(Map aParameters) throws FilterException

{

// для многих правил этот метод не используется, поэтому делаем

// его необязательным

}

public void initialize()

{

// так же, как и setParameters – делаем этот метод необязательным

}

public void setEnabled(boolean aEnabled)

{

_enabledThreadLocal.set(Boolean.valueOf(aEnabled));

}

public boolean isEnabled()

{

return ((Boolean) _enabledThreadLocal.get()).equals(Boolean.TRUE);

}

}

Стандартные правила (jfilter.rules.general)

BreakWorksRule – разбивает длинные слова пробелом.

EkranRule – правило экранирования спецсимволов.

MaxLengthRule – правило, которое ограничивает длину строк.

HTML-правила (jfilter.rules.html)

AnchoringRule – замена текста, начинающегося с http:// (или аналогов) и заканчивающегося пробелом, HTML-ссылкой.

MailRule – замена текста, заключенного в пробелы и содержащего символ «@», HTML-ссылкой.

Эмотиконы (jfilter.rules.smiles)

PreSmiler – замена обозначений эмотиконов («:-)», «;)» и так далее) на их стандартные обозначения для обработки SmilesRule’ом.

SmilesRule – замена одиночных слов, заключенных в парные двоеточия «::», HTML-картинками.

Транслитерация (jfilter.rules.transliteration)

Lat2RusTransliterationRuleGroup – транслитерация. Соответствует ISO и ГОСТ (то есть можно писать как по ГОСТу, так и обозначениями ISO; пока конфликтов такого варианта я не обнаружил).

Типографика (jfilter.rules.typografica)

AbbreviationsRule – замена (c), (p), (r), (tm) соответствующими HTML-символы.

HellipRule – замена трех точек подряд символом «многоточие».

LongDashRule – Замена символа «минус», обрамленного пробелами символом «тире».

QuotesRule – замена «знака дюйма» корректными кавычками для русского языка.

Вики-форматирование (jfilter.rules.wacko)

AnchorRule – создание ссылок в виде ((link)).

BlockquoteRule – цитата (>>текст>>).

BoldRule – выделение полужирным начертанием (**полужирный**).

HeaderRule – заголовок (==заголовок==).

ItalicRule – выделение курсивом (//курсив//).

MonospaceRule – выделение моноширинным шрифтом (##моноширинный##).

NoteRule – выделение замечания (span class=”note”).

ParagraphRule – Работа с переводами строки (одиночный перевод строки - <br/>, два подряд - <p>).

PreformattedRule – выделение предварительно отформатированного текста (%%уже форматрованный текст%%).

ReplaceAmpersandTagBracketRule – замена символа “&” соответствующим HTML-аналогом (&amp;).

ReplaceLeftTagBracketRule – замена символа “<” соответствующим HTML-аналогом (&lt;).

SmallRule – выделение мелким шрифтом (++мелкий++).

StrikeRule – выделение перечеркиванием (--перечеркнутый--).

sub>scriptRule – выделение нижним индексом (vvнижний индексvv).

SuperscriptRule – выделение верхним индексом (^^верхний индекс^^).

UnderlineRule – выделение подчеркиванием (__подчеркивание__).

Свойство

Классический способ

Регулярные выражения

Фильтрация

Простота реализации

Просто

Очень сложно

Сложно

Возможности изменения

Для простых задач – очень большие, для сложных – очень сложные

Только вместе с перекомпиляцией выражения

Максимальные

Простота использования

Очень просто

Просто для тех, кто потратил много времени на обучение

Очень просто

Скорость работы

Быстро на простых вариантах, обычно медленно на сложных, сильно зависит от реализации

Быстро, если правильно использовать

Быстро