Короткий ответ: это не имеет значения. Возможно, на уровне сборки может быть выставлен указатель; но это не было указано.
И на самом деле, комментарии ошибочны в отношении godoc и публичных (столичных) писем. Для исполняемых файлов (основная часть пакета), godoc
печатает только описание заголовка пакета //. Он не будет печатать какие-либо методы. Я пробовал это недавно и задавался вопросом, где была вся моя документация.
Вместо этого, что люди делают для приложений package main
, это добавить файл с именем doc.go в свой пакет. Поскольку спецификация godoc позволяет вам украшать package main
в любом месте любого файла, вы должны записать всю свою документацию здесь, в этом файле doc.go
, например:
/* This executable serves a special purpose
and that is say Hello World when it is run.
A tip for writing comments in go is to use
line-break, text, line-break to make headers,
like this.
This Is A Header
And the sub-text to the header goes here.
Also note that you can create indented
code with 4 spaces...
Like this.
And this.
And the above will be printed as code
blocks in -html output.
*/
package main
Обратите внимание, что текст выше украшает package main
в конце файла. Это весь текст в этом проекте doc.go.
Когда вы запустите go doc .
, он будет читать этот файл для вывода.
Кроме того, при запуске основного приложения и используйте -h или -help, этот текст также отображается на консоли. Сделайте это так же тщательно, как вам нравится, чтобы помочь пользователям.
Изменить: как упоминает Джеймс, да, вы можете импортировать другие основные пакеты. Но это отступает от идиоматического характера Go в первую очередь. Документы в Go даже говорят, что дублирующий код, в интересах удобочитаемости, отлично подходит. Это было тяжело и для проглатывания, исходя из .NET и использования DRY-принципов.
Первый пример выглядит хорошо для меня. Это как я сделал бы это сам:
<selectKey keyProperty="myId" resultType="java.lang.Integer" order="BEFORE">
SELECT ${proj_no}||WBS_${PROJ_NO}_SEQ.NEXTVAL FROM DUAL
</selectKey>
Не используйте #{proj_no}
, но ${proj_no}
. Первый - для параметров JDBC; последний (тот, который вам нужен) предназначен для SQL-инъекции.
В качестве альтернативы проблема может быть значением свойства PROJ_NO
(или это proj_no
?) приводит к недопустимому имени последовательности:
Кстати, не должно ли оно выглядеть более «java-like», что-то вроде projNo
?