Спецификация важно - это утверждение ясно всем. Широко используется продукт, технология или язык без спецификации не имеет смысла. Спецификации без TestSuite опасно. TestSuite без разметки и тестов невозможно. Этот процесс является довольно сложным. Однако Есть способы, чтобы упростить разметки этапе.
Что касается спецификации языка программирования Java (JLS) и (Виртуальных машин), они написаны в FrameMaker. После спецификации экспортируются в HTML и PDF. Разметки встраивается в HTML-версии. Мое мнение, что разметку информации должны быть помещены в (или связанные с ними) происхождения текста. В нашем случае это FrameMaker документа. Я не уверен, что это вообще возможно, но я думаю это. Если нет, то, может быть, FrameMaker не лучшее решение. В результате мы значительно уменьшить количество времени и усилий, необходимых для передачи старой разметки и маркировки до нового текста. Кроме того во время записи следующего пересмотра спектра автором совместно с TCK команда должна разметки все поменявшее и новые утверждения. Я бы сказал, лучше всего, когда спектр письменной форме и разметки процессы выполняются одновременно. Целесообразно для автора указывают на то, что разработчики тест отчетность должна быть проверена.
Простейшее определение метаданных, что это данные о данных. Метаданные могут быть очень полезны. Что касается разметки, существуют определенные метаданные встроенных: ID, небольшое описание утверждение, ссылка на тест. В разметки передачи я понял, что больше метаданных бы очень полезно. В новой версии спецификации существует несколько видов утверждений:
возраста: без измененный текст, тесты не нужны изменения;
oldToBeChanged: текст изменен, тесты должны быть изменены;
новое: суммарно новый текст, новые испытания необходимы;
newWritten: Новый текст, но испытания уже существует (потому что процесс развития испытания начались, как только проект был доступен спектр);
newWrittenToBeChanged: новый текст, тесты существуют, проект спектра изменить таким образом, испытания должны быть изменены или существующие тесты недостаточно.
Добавление такого рода данных для разметки значительно упростило бы будущей работы - испытательный развития. Потому что, просто глядя на утверждение в спектре можно легко сказать, если дополнительные испытания необходимы или нескольких должна быть обновлена.
С данной разметки архитектуры это было решено использовать название атрибута HREF-теги (второй якорь). Так разметки будет выглядеть так:
<a name=assertionID> <! - Шорд описание в виде HTML-комментарий -> утверждение выступлении здесь <img src="pics/assert.gif"> href="path <a к test" title=assertType> тест ID который так же, как утверждение ID </ A>
Название атрибута можно просматривать в браузере, как намек.
Весь процесс создания разметки и развивающихся испытаний времени. И когда кажется, что работа сделана, новая версия спецификации освобождены. Что происходит дальше? Конечно, есть необходимость в новой версии тестового пакета. Новые тесты должны быть написаны, а старые обновлены или даже исключить.
Самый лучший способ начать это делать разметку. Эта задача может быть разделена на две подзадачи:
передачи старой разметки с предыдущих спектр новой спектра (это необходимо, потому что многие испытания были уже написаны, они связаны спецификации идентификаторов, повторно все возможные тесты это хорошая идея);
разметки, новые и обновленные утверждений.
Перенос разметки является достаточно простым, чтобы сделать это вручную:
Найти теги разметки в старой спецификации.
Найти лучшее место для вставки тегов в новой версии спецификации.
Включить метку.
Если Есть только 10 утверждений - это работа кусок пирога. Но если Существуют тысячи это тяжелый труд, который должен быть автоматизирован. Самая трудная часть, чтобы найти новых правильное место для разметки тегов. Трудно только потому, что спектр был изменен. Для JLS2 JLS3 в процессе миграции flollowing alrorithm были использованы:
Каждое утверждение округляется с HTML якорей. Оба они должны быть переданы с использованием таких алгоритмов.
Хин 1T: если некоторые теги передается, есть большая вероятность того, что следующий тег в старых спектра будут размещены после 1, которая передается.
Подсказка 2: алгоритм должен проверить, что второй якорь должен быть установлен после первого 1 и не слишком далеко от него.
Посмотрите на текст перед и после тега в старой спецификации. Найти ее в новой спецификации. Если один из них не изменилась - ответ найден. Обычно длина должна быть на 1-2 sentances, по крайней мере 60 символов. Если ни один или несколько sentances найдено - пропустить этот шаг.
Попробуйте сделать то же самое, как в (1), но удалить все HTML-теги к тексту, который окружает метки. Если никто не нашел - пропустить этот шаг.
Попробуйте принять алгоритм, который пытается найти подобный текст в новой спецификации. . Используйте действия (1) и (2), но desrease длина поиска текста в цикле, пока Сентанс находится или длина является слишком коротким. Практической работы показал, что этот номер не должен быть меньше 20. б. Если шаги (1) и (2), или (3, a) нашел несколько sentances увеличить длину текстового поиска, пока текст не находится в спектре новых или верхний предел (напр. 140 символов) будет достигнут. Использовать подсказки, чтобы найти наиболее подходящий текст.
Принять алгоритм может использоваться как с игнорируя HTML-теги и воспользоваться ими. Алгоритм подходит для спецификации написаны в виде простого текста, HTML или XML.
Этот алгоритм был реализован в JLS2-> JLS3 инструмент передачи разметки. 84% от разметки метки были переведены автоматически. Остальные были сделаны вручную.