barbitoff programmer`s blog

Здесь я публикую заметки из программерской жизни: грабли, на которые мне случилось наступить, проблемы, для которых было найдено элегантное (или не очень) решение, а также все, с чем мне пришлось столкнуться и чем хотелось бы поделиться =)
PS Если хотите меня поблагодарить - на странице есть 3 места, чтобы это сделать =)

вторник, 18 сентября 2012 г.

Netbeans 7.2 в Win 7: где запрятали ant?

Раньше (не помню правда, в какой версии) ant лежал в папке установки Netbeans (в подпапке вроде java/ant), теперь же он размещается тут:
%USERPROFILE%\AppData\Roaming\NetBeans\7.2\ant\
Чтобы узнать это, пришлось воспользоваться крайней полезным в некоторых ситуациях ant-заданием "diagnostics".
Соответственно, если есть необходимость подложить в ant jar-ники со своими заданиями (чтобы не привязываться в абсолютным / относительным путям в <taskdef/>), то класть их нужно в:
%USERPROFILE%\AppData\Roaming\NetBeans\7.2\ant\lib

понедельник, 17 сентября 2012 г.

JAX-WS: IllegalAnnotationsException "Two classes have the same XML type name" на ровном месте

Проблема:

Есть веб-сервис, построенный на JAX-WS, у которого есть веб-метод, реализующий soap-операцию "op", тип его возврата - OpResponse: 
@WebService(serviceName = " MyService ")
public class MyService
{
...
@WebMethod(operationName = "op")
public OpResponse op(...) {...}
...
}
...
public class OpResponse { ... }
При развертывании этого веб-сервиса валится ошибка:
com.sun.xml.ws.transport.http.servlet.WSServletException: WSSERVLET11: failed to parse runtime descriptor: javax.xml.ws.WebServiceException: Unable to create JAXBContext
...
Caused by: javax.xml.ws.WebServiceException: Unable to create JAXBContext
...
Caused by: java.security.PrivilegedActionException: com.sun.xml.bind.v2.runtime.IllegalAnnotationsException: 1 counts of IllegalAnnotationExceptions
Two classes have the same XML type name "{...}opResponse". Use @XmlType.name and @XmlType.namespace to assign different names to them.
Хотя вроде бы никаких двух классов с одинаковым XML-типом в проекте нет (впрочем, XML-типы пока явно вообще нигде не фигурируют).

Причина:

Причину ошибки можно объяснить с двух сторон - с точки зрения классов или с точки зрения генерируемых jaxws`ом WSDL/XSD. Я приведу второе объяснение.
Генерируя WSDL, JAX-WS использует имя "opResponse" как имя XSD-типа ответа операции "op" (т.е. он просто конкатенирует имя операции и "Response"), который потом уже, в XSD-схеме, раскрывается с использованием XSD-типа, соответствующего возвращаемому Java-классу:
<operation name="op">
<input wsam:Action="http://.../opRequest" message="tns:op"/>
<output wsam:Action="http://.../opResponse" message="tns:opResponse"/>
</operation>
<xs:complexType name="opResponse">
<xs:sequence>
<xs:element name="return" type="tns:<responseClassName>" minOccurs="0"/>
</xs:sequence>
</xs:complexType> 
Здесь <responseClassName> - это имя класса, который является типом возврата метода "op", написанное со строчной первой буквы. В нашем случае это имя должно было бы быть равным снова "opResponse", т.к. тип возврата метода "op" - именно класс OpResponse, что сделало бы XSD-схему некорректной.

Решение:

Аннотировать класс OpResponse с помощью аннотации @XmlType, как и советует JAX-WS, так, чтобы имя XSD-типа, соответствующего классу OpReponse, отличалось от "opResponse", например:
@XmlType(name = "OpResponseType")
public class OpResponse {...}
Тогда схема примет вид:
...
<xs:complexType name="opResponse">
 <xs:sequence>
  <xs:element name="return" type="tns:OpResponseType" minOccurs="0"/>
 </xs:sequence>
</xs:complexType>
...
и веб-сервис стартанет без проблем. 

суббота, 15 сентября 2012 г.

Проект away3d 4.0 в Flash Builder 4.6: пустой экран и ошибка "Класс Context3D недоступен"

Проблема:

Создал ActionScript-проект в Flash Builder 4.6, подключил сорцы away3d 4.0, но при запуске даже элементарных примеров с away3d.com получаю пустой экран и ошибку (если установлен отладочный Flash Player):
Error #2044: Необработанный ErrorEvent:. text=Error #3702: Класс Context3D недоступен.
Решение:

Открыть html-шаблон, который используется для запуска проекта, и установить в нем параметр wmode равным "direct" в JavaScript-коде создания swf-объекта:

<script type="text/javascript">
            // For version detection, set to min. required Flash Player version, or 0 (or 0.0.0), for no version detection.
            var swfVersionStr = "${version_major}.${version_minor}.${version_revision}";
            // To use express install, set to playerProductInstall.swf, otherwise the empty string.
            var xiSwfUrlStr = "${expressInstallSwf}";
            var flashvars = {};
            var params = {wmode: "direct"};
            params.quality = "high";
            params.bgcolor = "${bgcolor}";
            params.allowscriptaccess = "sameDomain";
            params.allowfullscreen = "true";
            var attributes = {};
            attributes.id = "${application}";
            attributes.name = "${application}";
            attributes.align = "middle";
            swfobject.embedSWF(
                "${swf}.swf", "flashContent",
                "${width}", "${height}",
                swfVersionStr, xiSwfUrlStr,
                flashvars, params, attributes);
            // JavaScript enabled so display the flashContent div in case it is not replaced with a swf object.
            swfobject.createCSS("#flashContent", "display:block;text-align:left;");
        </script>
Это включит аппаратное 3D-ускорение. Предыдущие версии библиотеки работали с другими wmode`ами (transparent, opaque), что, конечно, давало проигрыш в производительности, но всё же. У wmode=direct есть одна особенность: объекты View3D всегда располагаются под остальным 2D-контентом, независимо от порядка их добавления в контейнер вызовом addChild и от индекса при добавлении с помощью addChildAt. Так что нужно быть осторожным, чтобы, например, случайно не залить 3d-сцену поверх как-нибудь заливкой.

пятница, 14 сентября 2012 г.

Orbeon: рестилизация печатной формы

При генерации pdf по форме (без использования собственного pdf-шаблона формы) Orbeon корректно обрабатывает правило @media, поэтому управлять стилем генерируемой pdf-ки можно с помощью css, устанавливая различные стили для @media screen и @media print.

четверг, 13 сентября 2012 г.

Netbeans 7.2: перемещение проектов между группами проектов

Группы проектов - отличная идея для IDE, но в NetBeans реализация пока что сыровата. Например, для того, чтобы переместить проект из одной группы в другую нужно его закрыть, переключиться в необходимую группу, и открыть его, находясь в ней. 
Переключение между группами также далеко от идеала юзабилити - только через контекстное меню окна "Проекты".

понедельник, 10 сентября 2012 г.

Xalan: двойной CR в CDATA-секциях

Наткнулся на баг в библиотеке Xalan (являющейся в моем случае реализацией по-умолчанию javax.xml.transform.TransformerFactory): при сериализации в Windows XML-документа с CDATA-секциями переводы строки в этих секциях представляются последовательностями CR-CR-LF вместо CR-LF. В баг трекере апача соответствующая заявка лежит уже давным-давно без ответа: https://issues.apache.org/jira/browse/XALANJ-2547. Выход - например, заменять вручную в полученной строке "\r\r\n" на "\r\n":

public static String domToString(Document dom) throws TransformerException
{
Source source = new DOMSource(dom);
StringWriter stringWriter = new StringWriter();
Result result = new StreamResult(stringWriter);
TransformerFactory factory = TransformerFactory.newInstance();
Transformer transformer = factory.newTransformer();
transformer.transform(source, result);
return stringWriter.getBuffer().toString().replace("\r\r\n", "\r\n");
} 

пятница, 7 сентября 2012 г.

Ant: выполнение действий над каждым файлом из набора

Задача:

В билдфайле ant над каждым файлом из набора (заданного с помощью <fileset/>) выполнить некоторое действие или последовательность действий.

Решение:

Один из вариантов -  воспользоваться библиотекой Ant-Contrib (скачать её, а также почитать документацию можно тут: http://ant-contrib.sourceforge.net/, я использовал версию 0.6). Она предоставляет задачу <foreach/>, позволяющую задать набор файлов вложенным элементом <path/> и вызвать для каждого файла указанную цель, передав ей имя файла в качестве параметра. Вот небольшой пример:
<taskdef name="foreach" classname="net.sf.antcontrib.logic.ForEach"
             classpath="path/to/ant-contrib-0.6.jar"/>

<target ...>
<foreach target="mytarget" param="myfile">
<path>
<fileset dir="${basedir}">
<include name="*.jar"/>
</fileset>    
</path>
</foreach>
</target>

<target name="mytarget">
<echo message="filename is ${myfile}" />
</target>
Здесь foreach проходит по всем jar-файлам из базовой директории, и для каждого вызывает цель "mytarget", передавая ей абсолютный путь к файлу через параметр "myfile".

PS В принципе, в ant есть встроенная задача <apply/>, но она умеет выполнять для каждого файла из набора только внешние команды, а не внутренние цели.