Ваш Javascript будет выполняться на клиенте, а не на сервере. Это означает, что foo
не оценивается на стороне сервера, и поэтому его значение не может быть записано в файл на сервере.
Лучший способ подумать об этом процессе - это как будто вы генерируя текстовый файл динамически. Текст, который вы генерируете, становится исполняемым кодом после того, как браузер интерпретирует его. Только то, что вы размещаете между тегами <?php
, оценивается на сервере.
Кстати, создание привычки встраивать случайные фрагменты PHP-логики в HTML или Javascript может привести к серьезному запутанному коду. Я говорю от болезненного опыта.
Помимо уже упомянутых тегов <pre>
, вы также должны использовать аннотацию @code
JavaDoc, что значительно облегчит жизнь, когда дело касается проблем с объектами HTML (в частности, с помощью Generics), например:
* <pre>
* {@code
* Set<String> s;
* System.out.println(s);
* }
* </pre>
Дает правильный вывод HTML:
Set<String> s;
System.out.println(s);
Если опустить блок @code
(или с помощью тега <code>
) приведет к тому, что HTML будет выглядеть следующим образом:
Set s;
System.out.println(s);
(Для справки, описания тегов Java SE 8 можно найти здесь: Теги Javadoc )
Мне удалось создать хорошо выглядящие HTML-файлы со следующим snip-показанным в коде 1.
* <pre>
* {@code
* A-->B
* \
* C-->D
* \ \
* G E-->F
* }
*</pre>
(код 1)
Код 1 превращен в сгенерированный javadoc HTML-страница на рисунке 1.
A-->B
\
C-->D
\ \
G E-->F
(рисунок 1)
Однако в NetBeans 7.2, если вы нажали Alt + Shift + F (чтобы переформатировать текущий код), код 1 переходит в код 2.
* <
* pre>
* {@code
* A-->B
* \
* C-->D
* \ \
* G E-->F
* }
* </pre>
(код 2)
, где первый <pre>
теперь разбит на две строки. Код 2 создает сгенерированный HTML-файл javadoc, как показано на рис. 2.
< pre> A-->B \ C-->D \ \ G E-->F
(Рис. 2)
Представление Стив Б (Код 3), по-видимому, дает наилучшие результаты и остается форматированным как и ожидалось, даже после нажатия Alt + Shift + F.
*<p><blockquote><pre>
* A-->B
* \
* C-->D
* \ \
* G E-->F
* </pre></blockquote>
(код 3)
Использование кода 3 создает такой же выход javadoc HTML, как показано на рисунке 1.
Попробуйте заменить «код» на «pre». Предварительный тег в HTML отмечает текст как предварительно отформатированный, и все строки и пробелы будут отображаться точно так же, как вы их набираете.
Используя Java SE 1.6, похоже, что все идентификаторы UPPERCASE PRE - лучший способ сделать это в Javadoc:
/**
* <PRE>
* insert code as you would anywhere else
* </PRE>
*/
- это самый простой способ сделать это.
Пример из javadoc, который я получил из метода java.awt.Event:
/**
* <PRE>
* int onmask = SHIFT_DOWN_MASK | BUTTON1_DOWN_MASK;
* int offmask = CTRL_DOWN_MASK;
* if ((event.getModifiersEx() & (onmask | offmask)) == onmask) {
* ...
* }
* </PRE>
*/
Это производит вывод, который выглядит точно так же, как обычный код, с регулярными интервалами кода и новыми строками.
Если вы разработчик Android, вы можете использовать:
<pre class=”prettyprint”>
TODO:your code.
</pre>
Чтобы довольно печатать ваш код в Javadoc с кодом Java.
Я заключу свой примерный код с тегами <pre class="brush: java"></pre>
и использую SyntaxHighlighter для опубликованных javadocs. Это не мешает IDE и делает опубликованные примеры кода красивыми.
/**
* <blockquote><pre>
* {@code
* public Foo(final Class<?> klass) {
* super();
* this.klass = klass;
* }
* }
* </pre></blockquote>
**/
<pre/>
требуется для сохранения строк. {@code
должен иметь свою собственную строку <blockquote/>
, как раз для отступов. public Foo(final Class<?> klass) {
super();
this.klass = klass;
}
UPDATE с JDK8
Минимальными требованиями для правильных кодов являются <pre/>
и {@code}
.
/**
* test.
*
* <pre>{@code
* <T> void test(Class<? super T> type) {
* System.out.printf("hello, world\n");
* }
* }</pre>
*/
дает
<T> void test(Class<? super T> type) {
System.out.printf("hello, world\n");
}
И необязательное окружение <blockquote/>
вставляет отступ.
/**
* test.
*
* <blockquote><pre>{@code
* <T> void test(Class<? super T> type) {
* System.out.printf("hello, world\n");
* }
* }</pre></blockquote>
*/
дает
<T> void test(Class<? super T> type) {
System.out.printf("hello, world\n");
}
Вставка <p>
или окружение с помощью <p>
и </p>
дает предупреждения.
У меня было очень трудное время с включением конкретного примера кода в комментарий javadoc. Я хотел бы поделиться этим. Обратите внимание на следующее:
<code>
- для предотвращения интерпретации фигурных скобок {@code ...}
- тега для получения дженерики, включенные в выход @Override
через «{@literal @}Override
», потому что генератор javadoc «наклоняется» из-за того, что @ идет непосредственно после открытия фигурной скобки {@code
и {@literal
, чтобы компенсировать внутренние пространства и сохранить выравнивание код javadoc:
/** this methods adds a specific translator from one type to another type. `
* i.e.
* <pre>
* <code>new BeanTranslator.Builder()
* .translate(
* new{@code Translator<String, Integer>}(String.class, Integer.class){
* {@literal @}Override
* public Integer translate(String instance) {
* return Integer.valueOf(instance);
* }})
* .build();
* </code>
* </pre>
* @param translator
*/
печатается как
new BeanTranslator.Builder()
.translate(
new Translator<String, Integer>(String.class, Integer.class){
@Override
public Integer translate(String instance) {
return Integer.valueOf(instance);
}})
.build();
Я просто прочитал ссылку Javadoc 1.5 здесь , и только код с <
и >
должен быть заключен внутри {@code ...}
. Вот простой пример:
/**
* Bla bla bla, for example:
*
* <pre>
* void X() {
* List{@code <String>} a = ...;
* ...
* }
* </pre>
*
* @param ...
* @return ...
*/
.... your code then goes here ...
Вам нужны теги <pre></pre>
для разрывов строк и {@code ... }
внутри них для дженериков. Но тогда не разрешается размещать открытую скобку в той же строке, что и тег <generic>
, потому что тогда все будет отображаться на 1 строке снова.
Отображается на одной строке:
* ..
* <pre>
* {@code
* public List<Object> getObjects() {
* return objects;
* }
* </pre>
* ..
Отображается с разрывами строк:
* ..
* <pre>
* {@code
* public List<Object> getObjects()
* {
* return objects;
* }
* </pre>
* ..
Еще одна странность в том, что при вставке закрывающей скобки {@code
она отображается:
* ..
* <pre>
* {@code
* public List<Object> getObjects()
* {
* return objects;
* }
* }
* </pre>
* ..
Выход:
public List<Object> getObjects()
{
return objects;
}
}
...
``). Тебе не нужны теги <code>
и <pre>
. Я отредактировал ваш ответ в этом уме.
– Paŭlo Ebermann
5 August 2011 в 04:24
У источника java есть много хороших примеров. Вот пример из главы «String.java»:
....
* is equivalent to:
* <p><blockquote><pre>
* char data[] = {'a', 'b', 'c'};
* String str = new String(data);
* </pre></blockquote><p>
* Here are some more examples of how strings can be used:
* <p><blockquote><pre>
* System.out.println("abc");
* String cde = "cde";
* System.out.println("abc" + cde);
* String c = "abc".substring(2,3);
* String d = cde.substring(1, 2);
* </pre></blockquote>
...
List<String>
. Для этого я использую <pre>{@code ... }</pre>
.
– Daniel
28 August 2016 в 16:29
Существует значительная разница между <blockquote><pre>...
и <pre>{@code....
. Первый будет опускать объявления типов в generics, но последний сохранит его.
E.g.:
List<MyClass> myObject = null;
отображается как List myObject = null;
с фр. и как List<MyClass> myObject = null;
со вторым
Приложите многострочный код к тегам <pre></pre>
.