documentation/addons/addons-troubleshooting.asciidoc


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

---
title: Troubleshooting
order: 6
layout: page
---

[[addons.troubleshooting]]
= Troubleshooting

If you experience problems with using add-ons, you can try the following:

* Check the [filename]#.gwt.xml# descriptor file under the the project root
package. For example, if the project root package is
[filename]#com.example.myproject#, the widget set definition file is typically
at [filename]#com/example/project/AppWidgetset.gwt.xml#. The location is not
fixed and it can be elsewhere, as long as references to it match. See
<<dummy/../../../framework/clientside/clientside-module#clientside.module,"Client-Side
Module Descriptor">> for details on the contents of the client-side module
descriptor, which is used to define a widget set.

* Check the [filename]#WEB-INF/web.xml# deployment descriptor and see that the
servlet for your UI has a widget set parameter, such as the following:


+
----
<init-param>
  <description>UI widgetset</description>
  <param-name>widgetset</param-name>
  <param-value>com.example.project.AppWidgetSet</param-value>
</init-param>
----
+
Check that the widget set class corresponds with the [filename]#.gwt.xml# file
in the source tree.

* See the [filename]#VAADIN/widgetsets# directory and check that the widget set
appears there. You can remove it and recompile the widget set to see that the
compilation works properly.

* Use the [guilabel]#Net# tab in Firebug to check that the widget set (and theme)
is loaded properly.

* Use the ?debug parameter for the application to open the debug window and check
if there is any version conflict between the widget set and the Vaadin library,
or the themes. See
<<dummy/../../../framework/advanced/advanced-debug#advanced.debug,"Debug Mode
and Window">> for details.

* Refresh and recompile the project. In Eclipse, select the project and press F5,
stop the server, clean the server temporary directories, and restart it.

* Check the Error Log view in Eclipse (or in the IDE you use).
/* ====================================================================
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
==================================================================== */

package org.apache.poi.sl.draw;

import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

import org.apache.poi.util.Internal;


/**
 * This is a marker annotation for classes which don't have a defined
 * draw implementation.
 */
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Internal
public @interface DrawNotImplemented {
}