Full package name?

All,
I am very new to Javadoc. I would like to know how (if possible) to eliminate the full package name from any descriptions. For example, if I have a method that returns a Hashtable, the Javadoc that gets generated looks like this:
public static java.util.Hashtable newMethod()
I would like it to look like this:
public static Hashtable newMethod()
I'm using the Eclipse tool, and that is actually calling Javadoc and passing the appropriate parms (v1.4).
I'm new to Javadoc, so I don't know if the generated method (with the package name) is preferred. I've also read some of the forum's comments on how to get started with this. I'm attempting to consolidate the lengthy Javadoc documentation, and some of the comments I've read have been helpful.
Thanks,
Van Williams

The default should display the package name only
for classes not in the "current" package.
For 1.4, use "-noqualifier all" to prevent the package
name from appearing ahead of the class name
for all packages. This is further described at:
http://java.sun.com/j2se/1.4/docs/tooldocs/windows/javadoc.html#noqualifier
You can reduce the confusion this may cause
by using -linkoffline to create links to
classes not being documented, such as to
java.util.HashTable in your example. This
is further described at:
http://java.sun.com/j2se/1.4/docs/tooldocs/windows/javadoc.html#linkoffline
-Doug Kramer
Javadoc team

Similar Messages

  • Full package name needed when using FindClass?

    When loading a class for use by the invocation interface, do I need to use the full package name of the class to be loaded, or just the class name?
    For example, I have a program called MyProg. It is part of package MyProg, and when I run it, I have to do so using java MyProg.MyProg.
    When loading the class, I've tried both of the following:
    cls = (*env)->FindClass(env, "MyProg\\MyProg");
    cls = (*env)->FindClass(env, "MyProg");Neither one works. Anyone know for sure which one it shoulf be? I suspect that there is a classpath issue coming into play as well, but that's another post. :)

    Thanks! Just to clarify, this is on a Win32 machine.

  • Import vs full package name

    So, I decided to fumble a bit with JavaFX. After having gotten myself a sh*tload of stress doing stuff in Flash and Actionscript, I'm ready for something that is intended as "code" from the ground up. One thing I ran into is this: AFAIK I have two identical custom nodes, the only difference is that one uses full package names and the other uses imports. The components just show an image.
    Full package version:
    public class SfeerNode extends javafx.scene.CustomNode
        public var sfeerimage : javafx.scene.image.Image;
        override function create() : javafx.scene.Node
            return javafx.scene.Group
                content:
                [     javafx.scene.image.ImageView
                          image: sfeerimage
    }And the import version:
    import javafx.scene.*;
    import javafx.scene.image.*;
    import javafx.scene.paint.*;
    import javafx.scene.shape.*;
    public class SfeerNode2 extends CustomNode
        public var sfeerimage : Image;
        override function create() : Node
            return Group
                content:
                [     ImageView
                          image: sfeerimage
    }Usage is very straight forward, just like ImageView, and I can toggle between the two by simply adding or removing "2" after "SfeerNode" in the main code.
    The problem: the full package version does NOT show the image, the import version does.
    Why?

    It is definitely a bug.
    It is possible to extend only CustomNode class to make the first sample work .
    import javafx.scene.CustomNode;
    public class A extends CustomNode {
        public var sfeerimage : javafx.scene.image.Image;
        override function create(): javafx.scene.Node{
            return javafx.scene.Group {
                content:[ javafx.scene.image.ImageView {
                          image: sfeerimage
    }

  • Class will only run with full package path - why?

    Hi,
    I've recently used Ant to package up a jar file with a simple gui application. Though I believe I've done everything right in terms of packaging I find that when I copy jar file to another computer not only do I need to unjar it I also need to use the full package name in order to get it to run. I thought that I should be able to run it by either using: java -jar CheckLogs
    or jar -xvf logUtils.jar, and then java CheckLogs.
    Instead only this will work:
    java net.kenjanuski.utils.CheckLogs
    My understanding is that if I put package net.kenjanuski.utils at top of file that I shouldn't have to use the full package name. Am I missing something obvious? By the way Ant did create the proper directory structure if I unpack the jar: net/kenjanuski/utils/...
    Thanks for any ideas,
    Ken

    I'm not going to try to answer the jar question, but as far as package name goes, if your CheckLogs class starts with the statement "package net.kenjanuski.utils;" then the fully qualified name of the class is net.kenjanuski.utils.CheckLogs. The java.exe command uses the fully qualified name of the class. So the only way it will work is "java net.kenjanuski.utils.CheckLogs" just as you found out.
    You can run the Jar file if you define the class in a Manifest file. See http://java.sun.com/docs/books/tutorial/jar/basics/run.html

  • Package Names

    This is another of my questions related with naming. My problem is that I care so much on naming of packages, classes, methods, variables, etc because I want to make my code as readable as possible.
    I read from google about some standards when creating a new package. It states that it must the company domain in reverse. This means "com.companyname.xxxx" or "org.organizationname.xxxx" like "org.eclipse.xxxx" or "com.nokia.xxxx". So far so good...
    My problems comes when I have to devide the application classes. I most often use the MVC. so what I do is having
    org.organizationname.applicationname.view
    org.organizationname.applicationname.control
    org.organizationname.applicationname.model
    org.organizationname.applicationname.utilHowever I am finding this a little stupid. My problem is I never seen any full application code and so I had to invent these myself. I sometimes change from .control to .business or .services.
    My question is how do you usually name the packages to identify between the view, model, control classes??
    I also get confused on how to set the package name for an application that will make use of a webservice. Because a webservice is a service, but you could have other things that can be a service. And you can not make your package name too long either!!

    This is another of my questions related with naming.
    My problem is that I care so much on naming of
    f packages, classes, methods, variables, etc because
    I want to make my code as readable as possible.
    I read from google about some standards when creating
    a new package. It states that it must the company
    domain in reverse. This means "com.companyname.xxxx"
    or "org.organizationname.xxxx" like
    "org.eclipse.xxxx" or "com.nokia.xxxx". So far so
    good...
    "Must" is a very strong word. I believe "recommends" is more correct. We use the reversed URL convention for package names where I work, but it's not mandatory.
    My problems comes when I have to devide the
    application classes. I most often use the MVC. so
    what I do is having
    org.organizationname.applicationname.view
    org.organizationname.applicationname.control
    org.organizationname.applicationname.model
    org.organizationname.applicationname.util
    However I am finding this a little stupid. What's so stupid? That's the way I see it done.
    I think it's only a problem if (1) you can't touch type, (2) you don't have an IDE like IntelliJ that can automatically insert the package name for you when create a class in a package, or (3) you're bothered by a bit of verbosity.
    My
    problem is I never seen any full application code and
    so I had to invent these myself. I sometimes change
    from .control to .business or .services.
    My question is how do you usually name the packages
    to identify between the view, model, control
    classes??Yes.
    I also get confused on how to set the package name
    for an application that will make use of a
    webservice. Because a webservice is a service, but
    you could have other things that can be a service.Every service is not a web service - two different things. It's a packaging/deployment issue. The fact that you choose to deploy a particular service as a Web service doesn't change its essence.
    And you can not make your package name too long
    g either!!What do you mean by "too long"?
    Do you have a point or a question here?
    %

  • Mapping namespace to generated package name (clientgen)

    Hello,
    We have a need to map the namespace of the generated bean artifacts from clientgen to a different package name. This could be done prior to weblogic 10 with the typePackageName attribute of clientgen but this is no longer supported in weblogic 10. Is there another way to do this? Note we cannot change the namespace of the webservice wsdl we are generating the client for.
    Thank you!
    Julia Allen

    Use the <binding> child element to specify one of the following:
    * For JAX-WS, one or more customization files that specify one or more of the following:
    o JAX-WS and JAXB custom binding declarations. For more information, see “Customizing XML Schema-to-Java Mapping Using Binding Declarations” in Getting Started With WebLogic Web Services Using JAX-WS.
    o SOAP handler files. For more information, see “Creating and Using SOAP Message Handlers” in Programming Advance Features of WebLogic Web Services Using JAX-WS.
    * For JAX-RPC, one or more XMLBeans configuration files, which by convention end in .xsdconfig. Use this element if your Web Service uses Apache XMLBeans data types as parameters or return values.
    The <binding> element is similar to the standard Ant <Fileset> element and has all the same attributes. See the Apache Ant documentation on the Fileset element for the full list of attributes you can specify.
    Note:      The <binding> element replaces the <xsdConfig> element, which is deprecated as of version 10.0 of WebLogic Server.
    See here for detail.

  • How to omit package names?

    Hello all,
    I'm new to javadoc and trying to format my classes sames as the
    sdk doc. The problem is that in the sdk doc on top of the page
    the tree shows the classes with package names, and in the
    parameter lists etc. the package names, e.g. for "String",
    are not shown. How can I do this? I want to get exactly the
    same documentation format as the sdk doc.
    With -noqualifier I can not do what I want. I only can get all
    classes full qualified or no class at all.
    Thanks in advance.
    bye
    Marcus

    We have also addressed this problem in DocFlextor for Javadoc v1.1
    by introducing two new template parameters:
    (1) Omit package qualifiers started with
    (2) Omit all package qualifiers
    You may use freeware DocFlextor Doclet:
    http://www.filigris.com/downloads/
    or look at the whole thing:
    http://www.filigris.com/products/docflextor_for_javadoc/
    -- Leonid Rudy

  • Package name from classname .class

    Is there any way to know the package name of the class from its .class without using the Reflection API's since there we need to instantiate the class with its fully qualified name. Can anybody suggest a method to do it.

    javap requires the name of fully qualified class, so
    if you are not aware of it, this utility will not
    work.
    We cannot create an instance of the class, if we donot
    know the full name of the class <including the package
    name>
    Both the above ways I think will not satisfy the
    purpose.I'm having a hard time understanding why anyone would want to instantiate a class they don't know anything about, or how anyone could expect to do so.

  • Trivial Windows XP package name problem

    I'm trying to run some of my Java apps under XP (I usually work with Linux) and haven't been able to get my package names recognized. (There are many postings on this subject but I haven't found one that solves the problem).
    I'm trying to run apps from the 'Command Prompt' (is there another way?). Unnamed packages are no problem, i.e.
    java TestClassworks, so the JRE is correctly installed. But things like
    java package0.package123.MyClassyield the java.lang.NoClassDefFound exception.
    I executed the above command from the directory containing the top level package ('package0'). I also tried
    java -classpath . package0.package123.MyClassand
    java -classpath C:\FULL\PATH\TO\DIR package0.package123.MyClasswith the same results.
    Could the problem be that my package names are longer than 8 characters?
    I'm sure there is a very simple solution. Any suggestion would be greatly appreciated - this is driving me nuts.
    Thanks,
    bw

    1. you have to have at the begining at your java file:
    package package0.package123;
    //import statements
    class MyClass{}
    2. your MyClass.class should be in the directory structure
    package0\package123\MyClass.class
    3. if you have this directory structure for instance in c:\temp, then type java -classpath c:\temp package0.package123.MyClass or
    java -classpath "c:\temp" package0.package123.MyClass

  • I need to remove "air." from package name. I'm get a Layout xml error when repackaging android app..

    So, i'm doing this on my own app. I made an update for an older app that was build using Native Android. But this time, i used Adobe AIR... The catch is Adobe likes to append a "air." to the front of your package name without asking you. So basically I can't upload my update because it has a new package name is now "air.com.mycompany.myapp" rather than the original "com.mycompany.myapp"
    Basically I'm going through this guide..
    http://helpx.adobe.com/air/kb/opt-out-air-application-analytics.html
    I followed all the steps, made all the adjustments to the androidmanifest.xml like it asks.
    But after going along with the above guide, with no issues when i get to the step that says
    "Run the following command to create the resource file for the updated AndroidManifest.xml:"
    I run this..
        "/Users/brybam/Documents/eclipse/android-sdk-mac_x86/platform-tools/aapt" package -f -M AndroidManifest.xml -F resources.arsc -I "/Users/brybam/Documents/eclipse/android-sdk-mac_x86/platforms/android-8/android.jar" -S ./res
    But I keep getting the same error regarding the xml files in res/layout
        ./res/layout/expandable_chooser_row.xml:1: error: Error parsing XML: not well-formed (invalid token)
        ./res/layout/expandable_multiple_chooser_row.xml:1: error: Error parsing XML: not well-formed (invalid token)
        ./res/layout/main.xml:1: error: Error parsing XML: not well-formed (invalid token)
        ./res/layout/multiple_file_selection_panel.xml:1: error: Error parsing XML: not well-formed (invalid token)
        ./res/layout/ssl_certificate_warning.xml:1: error: Error parsing XML: not well-formed (invalid token)
    The guide doesn't say anything about these xml files, and im not sure what to do with these or how to handle them.
    If i go into the res/layout folder, and just delete these (i know they're necessary. But i just deleted them as a test, to get through the rest of the guide...)
    I was able to get through the rest of the steps in the guide fine, make an apk, and put it on my phone...only to find out the app will crash the moment you try to run it. Probably because i deleted the layout xml files...But i cant get the command i need to run above to accept them!
    So, earlier in the guide they have me use thing thing called the "AXMLPrinter2.jar" to make the AndroidManifest.xml readable so i can edit it.
    I run something like this:
        java -jar "/Users/brybam/Desktop/repackage/AXMLPrinter2.jar" AndroidManifest.xml > AndroidManifest.xml.bk
    This makes a new file "AndroidManifest.xml.bk" and i can edit that.
    So, I was thinking with all of these layout xml files, maybe I could run this "AXMLPrinter2.jar" on them and then edit them. Because right now if you open them they're not human readable, and its hard for me to work on them if they're not...
    I tried this thinking i could do the same thing...
        java -jar "/Users/brybam/Desktop/repackage/AXMLPrinter2.jar" main.xml > main.xml.bk
    Just get a blank file and a console erorr when trying to use the AXMLPrinter2.jar on the layout xml files...
        java.lang.ArrayIndexOutOfBoundsException: 67
                  at android.content.res.StringBlock.getShort(StringBlock.java:231)
                  at android.content.res.StringBlock.getString(StringBlock.java:91)
                  at android.content.res.AXmlResourceParser.getName(AXmlResourceParser.java:140)
                  at test.AXMLPrinter.main(AXMLPrinter.java:56)
    So, I think my whole issue is based around these XML files not being converted to human readable before i try and re-package....
    EDIT:::
    Ok, so I found a site that talks about the error I'm getting but it's in chinese, and even after translating the page...I'm still not well versed with terminal and this stuff to get it.
    It reads:
    "Error.
    Final conclusion:
    In minSdkVersion <= 7, AXMLPrinter2.jar can normally decompile xml file
    Greater than 7 can not be normal decompile xml file (AndroidManifest.xml except)
    Give way to share a batch decompile xml file:
    First, create a *. Txt file
    Stresses inside the content authoring
    for / r layout%% a in (*. xml) do @ java-jar AXMLPrinter2.jar "%% a" >> "%% a". txt
    Then this txt file extension into bat form, and this BAT the file and AXMLPrinter2.jar on the same directory will be decompiled xml into the layout directory
    Decompilation results can be generated by executing the bat file multiple xml files."
    - http://hi.baidu.com/ghcghc/item/ecbaa1ce997cb225a0b50ac2
    Maybe someone with more know-how could explain what they're explaining? I get that he's saying the issue im seeing appears when you're using minSdK <=7 but I need to use minSdk 8. Does anyone understand this work around? And how I might go about it on a Mac with terminal?
    I wish adobe would make it easy to remove the "air." from the package name. If they want to convert old Native devs to AIR devs...the transition needs to be seamless. But now I'm about to have to go back to Native because I can't update an app I already have out on the market with an air app.

    Hello~
         I also tried to remove "air." package name in air application. And i encounter the same problem.
         I do not find any solution to decode the xml inside res folder by AXMLPrinter2.jar. And those xml inside is compressed which is unreadable.
         However, what you can do is copying the structure of res folder. And go to your air sdk file path -  adobeair-sdk-folder/lib/android/lib/resources/
         Replace those file exists in your res folder. And copy "values" folder to your res folder.
         Hope this solve your problem~

  • Class name and package name clashing

    When i have a class and a package with the same name, I cannot access classes in the package. For example I have 3 classes and 1 package as below
    - Test.java
    - PackageName.java
    + PackageName // this is a directory
    - MyClass.java
    Below are the codes of .java files
    Test.java
    =======
    public class Test { PackageName.MyClass a = new PackageName.MyClass ();}
    PackageName.java
    ===============
    public class PackageName{ }
    MyClass.java
    ==========
    package PackageName; public class MyClass { }
    I can compile PackageName.java and MyClass.java but not Test.java. It says
    cannot resolve symbol
    symbol : class MyClass
    location: class PackageName
    PackageName.MyClass a = new PackageName.MyClass ();
    But if I remove the PackageName.java, I can compile Test.java perfectly. I think when I use PackageName.MyClass, java thinks that I try to access an inner class MyClass of PackageName class, and that does not exists. Is there any way to solve this ambiguation, other than making the package name and class name different? Thank you very much.

    This works fine: just add an import to Test.java.
    import PackageName.MyClass;
    public class Test
        public static void main(String [] args)
            MyClass a = new MyClass();
    public class PackageName {}
    package PackageName;
    public class MyClass {}It's a pretty wacky, useless example, but it works.
    Plus I thought inner classes would have a dollar sign in their .class file names. When I compile this:
    public class OuterClass
        public static void main(String [] args)
            OuterClass outer = new OuterClass();
            System.out.println(outer);
        public String toString() { return "I'm an OuterClass"; }
        class InnerClass
            public String toString() { return "I'm an InnerClass"; }
    }I see two .class files: OuterClass.class and OuterClass$InnerClass.class
    Why make up examples like this? It's hard enough writing code, and it's easy to disambiguate for the compiler.

  • How to change the package name of Managed Bean class

    Hi: Gurus, when ever I create a new JSP page the Creator creates a code behind file with a package name untitled. Is there any way to change this package name? Can't the Creator gives us an option before genereating manged bean page to choose a package name? And then create the Java source directory structure on the basis of the pakcage name?
    Regards,
    Rashid.

    In the Project Navigator (default location is middle right), go to Java Sources, and you can rename the package ("untitled") to something else by right-clicking it or by left-clicking (just like Windows Explorer).
    I agree, though, that giving the developer an option during creation of the JSP page would be nice.

  • Is there a way to see the full album names on my iPod Touch?

    When albums have long names, they are cut off. This isn't normally a problem, except if the album is part of a multi-disc set, where the names all begin the same way, as shown in this screen shot of my iPod Touch
    At the end of each album name is a number (I, II, III).
    Is there a way to see full album names on iPod Touch?

    Flip the iPod horizontal and look at the cover flow mode. You will be able to see the complete album name, even if you don't have the artwork.

  • Full file names on Desktop Icons

    coming from 10.5, all of my desktop icons revealed the full file name. under the icons. Now on 10.6.2, they are "..." abbreviated. I've looked everywhere and through the "Show View Options" by right-clicking, it only allows me to choose between showing the file info (like size), but not the full names.
    Is there an option somewhere to address this?
    Thanks!

    Set the grid spacing wider in the view options (View menu, Show View Options).

  • The package name The Gallbladder-4.itmsp contains an invalid character(s).  The valid characters are: A-Z, a-z, 0-9, dash, period, underscore, but the name cannot start with a dash, period, or underscore

    I have an iBook on itunes and I am trying to upload a new version of the book. I am following the workflow through iBooks Author and when I fell out all of the infromation for the package on iTunes producer i then hit the deliver button and I get the following error message:
    The package name The Gallbladder-4.itmsp contains an invalid character(s).  The valid characters are: A-Z, a-z, 0-9, dash, period, underscore, but the name cannot start with a dash, period, or underscore.
    As far as I can tell the file that is being referenced does not meet the criteria axpressed in the erro message and in fact that file has been created by iBooks Author so one would think there shouldnt be an error.
    I also get the following to error messages:
    Apple's web service operation was not successful
            Unable to authenticate the package: The Gallbladder-4.itmsp
    Would ove any help.
    Thanks,
    Jeff

    Thank you so much for your help.
    For anyone that would like to check out this book it can be downloaded at:
    https://itunes.apple.com/us/book/the-gallbladder/id598317335?ls=1
    Please check out our free medical education blog by Jeffrey Eakin using iBooks Author at:
    http://free-medical-education-ibooks-author.blogspot.com

Maybe you are looking for

  • Members of the Smart List aggregated in the FR report

    I have a Hyperion Planning 9.3.1 application where one of the scenarios has SmartList associated with it. The SmartList is used on one of the forms, where accounts are in the rows and scenarios are in the columns. First value in the SmartList is "Yes

  • Apple TV / Homeshare no longer working

    I've got a 2nd generation Apple TV which has been working perfectly well for nearly a year. It's got the 5.1.1. update.  iTunes has the 11.0 update and is on an iMac running OS X 10.7.5 Since yesterday, whenever I go to the Computer menu, Apple TV ke

  • Problems running Application with Web Service Client

    Im having some problems maybe related to some classpath details? I am running a Web Service another computer which works fine. I have also made an application using Sun ONE Studio 1 consisting of a Web Service Client etc. and GUI which uses the Clien

  • Can you export the audio into a SINGLE file?

    I know I can export the individual slide audio, but can I export the audio for all the slides into one audio file? How? Thanks!

  • Bridge won't place files in Indesign

    Why will Bridge CC (Most Current) not place a file in Indesign CS2014. It will place in photoshop and illustrator