@(#) in Java file comment

What is this @(#) found in some Java source files?
For example, the first line in String.java in IBM jdk is the following:
* @(#)src/classes/sov/java/lang/String.java, core, hs131, 20021024 1.23.2.2Does the first line have to so with source control? What does the @(#) achieve here?
thanks

It's a "magic cookie" identifier that's searched for by the Unix command "what" (or maybe "whatis") that finds that particular sequence, and outputs the string following it. It's basically a versioning tool.

Similar Messages

Embedding html in .java file comments

for years now the convention has been to liberally use html in java source code comments
to beautify javadocs. for example, i have taken this out of the source code for java.lang.System:
* The <code>System</code> class contains several useful class fields
* and methods. It cannot be instantiated.
* <p>
* Among the facilities provided by the <code>System</code> class
* are standard input, standard output, and error output streams;
* access to externally defined "properties"; a means of
* loading files and libraries; and a utility method for quickly
* copying a portion of an array.
* @author Arthur van Hoff
* @version 1.125, 12/03/01
* @since JDK1.0
the problem i see with this is that the tags must be stripped if one is producing
documentation in formats other than html (swing doclet, or pdf doclet, or any
application of xml).
aren't we forever tying ourselves to html? is there any intention on the part of
j2se/j2ee developers to discontinue this practice? i've begun working on a xul
doclet and am having to enclose the documentation in cdata to maintain the
validity of the document i produce (i could also just strip out the tags of course).
thanks, eitan

Hi Eitan,
I see little problem as long we provide a way to
parse whatever format is being used.
Please take a look at the commentdom package in
the "Doclet Refactoring Design" under "What's New"
on the right side of the Javadoc home page:
http://java.sun.com/j2se/javadoc/
Here's its description:
com.sun.tools.doclet.toolkit.util.commentdom
DocComment to DOM Translator - Documentation comment contains embedded HTML,
Javadoc inline tags as well as custom inline tags. This package will contain classes that will help
generate a DOM tree for the documentation comment. This can be of great help for doclets that
generate documentation in formats other than HTML. Such doclets don?t have to undergo the
tedious task of parsing the documentation comments for all the tags. Doclets can then directly
traverse the DOM tree and then convert the tags to appropriate format.
The DOM tree will adhere to the doccomment DTD that will be published later. The DTD will
allow required HTML tags along with their attributes as defined in HTML4.0 specifications. The
DTD will also support Javadoc-defined inline tags as well as user-defined custom inline tags.
We plan for the doclet toolkit other than this part to be in Tiger;
we haven't committed dates to delivering this piece, but feel it
would be an important part of the toolkit.
-Doug Kramer
Javadoc team

Replacing Class definition comments in java files.

Hi to all,
Im trying to implement a java file replacer that opens about a thousand java files and replaces the first comment lines. That is to say assume that these thousand java files have this comment at the beginning of them:
*Date Author Changes
*${date} ${author} initial release
My application should find these comments and replace them with
* Project Name:
* File: ${file_name}
* Purpose:
* History:
*Date Author Changes
*${date} ${author} initial release
I dont need any GUI. just I will print the changed files to console.
My question is is there any example applications you guys can suggest and should I use XML and XSL to implement this application?
Any suggestions are highly appriciated.
Best Regards.
Metan

How is XML going to help you? Also for a task which you describe its easier to replace it wholesale rather than compare what is present and what is not. If you want to selectively want to remove stuff you might run into issues where you have to compare the name of the file, and you would not even know if the documentation already existing is the right one if you do not replace.
If at all you wish to go with XML it is better with XSL transforms but I guess that would be an overkill for the purpose.
As previously suggested perl is a very good option, or if you have unix operating system you can even try some basic shell scripting to do your job
Thanks

How to deal with #ifdef in .java files with javadoc tool?

My .java file included some '#ifdef' & '#endif' sentence. So when I used javadoc tool to generate the .html files, error happened. Can anyone give me some indication how to resolve the problem, provided that the source code can not be changed because it was written by others. Waiting for your reply and thanks in advance!

Hi, got the same problem, have stuck for all day on this and yield no progress.
my source code contain
#ifdef
and
#endif
it is source code (not comment), the only compile with a special preprocessing tool call
"sjpp.jar".
I need to generate Javadoc there.
the error is
[javadoc] C:\TEMP\cellml_visual_checkout\cellml_api\java\src\org\cellml\CNode.
java:101: illegal character: \35
[javadoc] #ifdef JENA
if I pass in encoding parameter when I do javadoc,
say, -encoding "PROPROC",
then there is different error
[javadoc] Constructing Javadoc information...
[javadoc] Standard Doclet version 1.5.0
[javadoc] Building tree for all the packages and classes...
[javadoc] java.lang.Error
[javadoc] at sun.nio.cs.StreamEncoder$CharsetSE.flushLeftoverChar(StreamEn
coder.java:361)
[javadoc] at sun.nio.cs.StreamEncoder$CharsetSE.implWrite(StreamEncoder.ja
va:381)
[javadoc] at sun.nio.cs.StreamEncoder.write(StreamEncoder.java:136)
[javadoc] at sun.nio.cs.StreamEncoder.write(StreamEncoder.java:146)
[javadoc] at java.io.OutputStreamWriter.write(OutputStreamWriter.java:204)
[javadoc] at java.io.PrintWriter.write(PrintWriter.java:384)
[javadoc] at java.io.PrintWriter.write(PrintWriter.java:401)
[javadoc] at java.io.PrintWriter.print(PrintWriter.java:532)
[javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printLink
(HtmlDocletWriter.java:1045)
[javadoc] at com.sun.tools.doclets.formats.html.MethodWriterImpl.printRetu
rnType(MethodWriterImpl.java:361)
[javadoc] at com.sun.tools.doclets.formats.html.MethodWriterImpl.writeSign
ature(MethodWriterImpl.java:148)
[javadoc] at com.sun.tools.doclets.internal.toolkit.builders.MethodBuilder
.buildSignature(MethodBuilder.java:176)
[javadoc] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
[javadoc] at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAcces
sorImpl.java:39)
any help will be appreciated.
thanks
Bill

A tool for editing javadoc in .java files

Hi
i am looking for a tool that can be use for editing the javadoc in the .java files. it should edit constructors, methods and fields.
if you know such tool please send me a link.
Regards
y.l.

We list some standalone solutions on the Javadoc FAQ.
(I have not tried any of these)
http://java.sun.com/j2se/javadoc/faq/index.html#G
- Utility for writing doc comments: Doc+.
- Tool that simplifies the process of writing doc comments: DocWiz.
- Tool for generating formated Javadoc comments: CommentMaster.
- Tool for editing Javadoc comments using a word processor-like view: XMLmind XML Editor.
-Doug Kramer
Javadoc team

How to compile and run java files on a mac using command line?

can someone tell me or link me to some article on how to compile and run java files from command line on a mac? I have mac OS X leopard

What do you mean by "where to put them" ? What do you want to put anywhere ?
Have you read Peter's comment in brackets ? Perhaps you have a classpath problem ?
Edited by: Michael_Knight on Aug 31, 2008 4:23 AM

BUG: error rebuilding SQLJ files along other java files with generic

I have done a rebuild on a package containing some SQLJ files, and (consistently) got the following error:
C:\TeleMessage\trunk\src\telemessage\db\impl\dbAdmin.sqlj
    Error(44,18): Java Parsing. Encountered: <
    Expected: <IDENTIFIER> ...; "[" ...; The error at the cursor in the given file is not possible, since there was no '<' there, and besides - if I non-aggresively changed the file, e.g. narrowed imports, changed whitespace or added comments - the error remained in the same location.
I went and done a search using regex in the package, for a line starting with 17 chars followed by a '<'.
I found it in one of the normal JAVA files (not-SQLJ), at line 44 (surprise!) - in a Java 5 generics declaration, e.g. Map<String,Integer>. the 18th character was indeed the '<'.
I'm guessing that the SQLJ translator (accidentally?) parses non-SQLJ files.
If this cannot be fixed, it is really bad - it is one thing that JDeveloper cannot support Java 5 language features because of its dependancy in the SQLJ translator (which is not known to be upgraded until version 11g if at all), but the inability to compile SQLJ files in a project containing other non-SQLJ java files with Java 5 features is hard.
I could only workaround this by rebuilding SQLJ files one at a time!
I also have another type of error, when rebuilding the same project in a higher-level pacakge (root or "Application Sources"):
C:\TeleMessage\trunk\src\dbtools\CallbackNumberFiller.sqlj
    Error(24,8): Missing semicolon.
    Error(24,8): Unbalanced curly braces.Again, the specified file could not be the one to blame - the location of the error is in the middle of the public modified keyword in a method declaration; nothing is neither missing nor unbalanced.
This appears to be different, as it pops in the log near the end of the build process, when the JSPs are being built, specfically during the time the message log fills with "writing <...>" lines (after "translating <...>" and "compiling <...>".
I can consistently reproduce both cases - please advise how I can help you find out what causes this.
Regards,
Yaniv Kunda

First of all, this bug not JDeveloper's problem, but the SQLJ team's.
You can read more posts about this:
Re: BUG: Cannot translate SQLJ files with Java5 generics code
Re: How to use SQLJ with Java 1.4 and 1.5?
Re: SQLJ discontinued??
And if we're at it, this is strange - I can't seem to find the oracle doc you quoted...
SQLJ 11g? The latest release is a part of JPublisher 10.2 available from
http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html
I also didn't find anything on google on 11g, nor about the part number you specified.
Didn't find any Java 1.5 supporting SQLJ translators from other vendors as well.
Do you have any link to this statement?
But if we examine this bug again, the problem involves JDeveloper passing Java 5 featured JAVA files to the SQLJ translator.
Isn't there a way to instruct the translator to use CLASS files compiled by a normal Java 5 compiler, instead of trying to compile the files itself?
Regards,
Yaniv Kunda

How to convert class files into java files??

Hey Guys,
I need a little help.
I want to know wheather we can view .class files as .java files or convert the .class to .java files.Is ther any tool or software for doing that.
Or in other words can i see the source code of any .class file..??
Plz do tell me if we can do that or any other way we can do that.
Regds,
Gokul

Sort of. A "decompiler" will take a class file and generate a source code file of source code that could be compiled to get the class file you started out with. However, it won't be the same source code that was originally used to create the class. Most notably, comments will be missing, and variable names will probably be meaningless.
And before you say "java is bad because you can decompile it", note that any language that you can execute you can theoretically decompile.
Also, you can view the raw byte codes. If you're familiar with assembly language, or better yet familar with java bytecodes and the JVM in particular, you can often find out what a particular method does just by viewing the byte codes.

How to keep HTML code in the applet source (.java) file itself?

Hi,
How to keep HTML code (APPLET tag) in the applet source (.java) file itself?
Please give an example?
thank you,

R6i wrote:
...What I mean is without writing external HTML file, how to run an applet (during practice)?'Practice'? What does that mean? During development? If that is what you are referring to, add an applet tag at the top of YourApplet.java inside a Java comment area. Then AppletViewer (in recent SDKs) can then run it with just..
prompt:javac YourApplet.java
prompt:// the '.java' extension is not a mistake
prompt:appletviewer YourApplet.javaIf you do not mean 'during development', then that brings us back to +"What advantages do you see that is bringing to the end user?".+

Simple Question Calling methods from Java files through JSP without JVM

Hi.
I've got a simple question (forigve my newbieness)...
If I'm running Tomcat can I exectue a method in a compiled Java file from a JSP page without having the JVM installed on the server?
Any thoughts or additional comments would be appreciated.
Many thanks.

No... but that's because you can't run Tomcat without
a JVM installed on the server.
If you are running Tomcat, you are running a JVM for
the JSP pages to run in, in which case, yes, the JSP
pages can call the other Java code... as long as it's
in the classpath.Thanks a lot for the replies.
So just to check, if I sign up with a hosting company that offers Tomcat then the JVM will be installed on the server and I can call other Java code as long as it's in the classpath?
I just want to make sure before I sign up with a hosting company =D
Thanks again!

Until how many lines can we write java file

in java file, how many lines can I write?
Manybe It will depend on file system such as window, unix file system.
but, I don't know the exact size.
please let me know how many lines I can wirte in java file of window and unix file system.
thank you in advance.

A class and method implementation in source lines of code (sans comments and white space) should be as large as necessary, but no larger. Good design principals tend to drive towards smaller peices, but there is no one right size size limit.
Personally, I suspect any method that has over 50 lines of code as being too large and probably refactorable. I also suspect any single class (or for that matter .java file) with more than 50 methods or more than 2000 lines of code as being too large and probably refactorable. But sometimes we might really need a 500 line method or an 8000 line, 200 method class. Maybe its a performance thing. Maybe it is just that complicated and too hard to break up. I doubt it occurs frequently, but I won't be shocked when I see it.
Sometimes GUI classes (Swing and AWT) get really huge. Sometimes this is due to code generation, sometimes its just being sloppy. It pays to know the difference.
But the Java langauge sets reasonable (if not overly generous) limits on bytecode and constant pool sizes If the Java compiler begins to complain that something you have built is is too large, face it, it probably is. It's like running into scope nesting or nested name (class in a class in a class...) size limits - usually not a good sign for the structure of your code.
Chuck

Create javadoc for java files under development

hi
i would like to know if there is any method by which i can generate javadoc of java files that are in the process of development.
What i do is first create a skeleton java file with just the methods defined along with their javadoc comments and then start implementing the methods.
I do a daily build of javadoc and hence its not necessary that a coding of a particular method is completed before javadoc is run.
sibi

it dint work for me. i have a sample code
public class HelloWorld
      * Sample Hello world. Note the 3rd System.out.print is missing a ";" and hence
      * should cause a compile error and Javadoc must have no problem running.
     public static void main()
          System.out.print("H");
          System.out.print("E");
          System.out.print("L")     //Note ";" is missing
          System.out.print("LO WORLD");
          System.out.println();
}Note the 3rd System.out.print has a ";"missing and must generate an error when compiling but the javadoc must run properly. Note the method main() is fully defined with parameters and return types.
Pls correct me if i am wrong.
sibi

I am trying to use java file as Model layer and jsf as presentation layer

I am trying to use java file as Model layer and jsf as presentation layer and need some help
I successfully get the value of h:outputText from java file by doing simple binding operation but I am facing problems when I am trying to fill h:dataTable
I create java file
package oracle.model;
import java.sql.;*
import java.util.;*
*public class TableBean {*
Connection con ;
Statement ps;
ResultSet rs;
private List perInfoAll = new ArrayList();
*public List getperInfoAll() {*
perInfoAll.add(0,new perInfo("name","username","blablabla"));
return perInfoAll;
*public class perInfo {*
String uname;
String firstName;
String lastName;
*public perInfo(String firstName,String lastName,String uname) {*
this.uname = uname;
this.firstName = firstName;
this.lastName = lastName;
*public String getUname() {*
return uname;
*public String getFirstName() {*
return firstName;
*public String getLastName() {*
return lastName;
right click on the file and choose 'create data control'
then i wrote the jsf file:
*<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h"%>*
*<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f"%>*
*<f:view>*
*<h:dataTable id="dt1" value="#{bindings.perInfoAll}"*
var="item" bgcolor="#F1F1F1" border="10"
cellpadding="5" cellspacing="3" rows="4" width="50%"
dir="LTR" frame="hsides" rules="all"
*>*
*<f:facet name="header">*
*<h:outputText value="This is 'dataTable' demo" id="ot6"/>*
*</f:facet>*
*<h:column id="c2">*
*<f:facet name="header">*
*<h:outputText value="First Name" id="ot1"/>*
*</f:facet>*
*<h:outputText style="" value="#{item.firstName}"*
id="ot2"/>
*</h:column>*
*<h:column id="c4">*
*<f:facet name="header">*
*<h:outputText value="Last Name" id="ot9"/>*
*</f:facet>*
*<h:outputText value="#{item.lastName}" id="ot8"/>*
*</h:column>*
*<h:column id="c3">*
*<f:facet name="header">*
*<h:outputText value="Username" id="ot7"/>*
*</f:facet>*
*<h:outputText value="#{item.uname}" id="ot4"/>*
*</h:column>*
*<f:facet name="footer">*
*<h:outputText value="The End" id="ot3"/>*
*</f:facet>*
*</h:dataTable>*
*</center>*
*</af:document>*
*</f:view>*
but nothing is appear in my table
I know that there is something wrong in calling the binding object
I need help pls and where can i find some help to deal with another tag types
thanks

i dragged the "perInfoAll" from my "Data Controls" and choosed adf table (even I know that new table with adf tags well be generated and i want table with jsf tags)
and this code is generated
*<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"*
*"http://www.w3.org/TR/html4/loose.dtd">*
*<%@ page contentType="text/html;charset=UTF-8"%>*
*<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f"%>*
*<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h"%>*
*<%@ taglib uri="http://xmlns.oracle.com/adf/faces/rich" prefix="af"%>*
*<f:view>*
*<af:document id="d1">*
*<af:messages id="m1"/>*
*<af:form id="f1">*
*<af:table value="#{bindings.perInfoAll1.collectionModel}" var="row"*
*rows="#{bindings.perInfoAll1.rangeSize}"*
*emptyText="#{bindings.perInfoAll1.viewable ? 'No data to display.' : 'Access Denied.'}"*
*fetchSize="#{bindings.perInfoAll1.rangeSize}"*
*rowBandingInterval="0"*
*selectionListener="#{bindings.perInfoAll1.collectionModel.makeCurrent}"*
*rowSelection="multiple" id="t1">*
*<af:column sortProperty="uname" sortable="false"*
*headerText="#{bindings.perInfoAll1.hints.uname.label}"*
*id="c1">*
*<af:inputText value="#{row.bindings.uname.inputValue}"*
*label="#{bindings.perInfoAll1.hints.uname.label}"*
*required="#{bindings.perInfoAll1.hints.uname.mandatory}"*
*columns="#{bindings.perInfoAll1.hints.uname.displayWidth}"*
*maximumLength="#{bindings.perInfoAll1.hints.uname.precision}"*
*shortDesc="#{bindings.perInfoAll1.hints.uname.tooltip}"*
*id="it3">*
*<f:validator binding="#{row.bindings.uname.validator}"/>*
*</af:inputText>*
*</af:column>*
*<af:column sortProperty="firstName" sortable="false"*
*headerText="#{bindings.perInfoAll1.hints.firstName.label}"*
*id="c2">*
*<af:inputText value="#{row.bindings.firstName.inputValue}"*
*label="#{bindings.perInfoAll1.hints.firstName.label}"*
*required="#{bindings.perInfoAll1.hints.firstName.mandatory}"*
*columns="#{bindings.perInfoAll1.hints.firstName.displayWidth}"*
*maximumLength="#{bindings.perInfoAll1.hints.firstName.precision}"*
*shortDesc="#{bindings.perInfoAll1.hints.firstName.tooltip}"*
*id="it2">*
*<f:validator binding="#{row.bindings.firstName.validator}"/>*
*</af:inputText>*
*</af:column>*
*<af:column sortProperty="lastName" sortable="false"*
*headerText="#{bindings.perInfoAll1.hints.lastName.label}"*
*id="c3">*
*<af:inputText value="#{row.bindings.lastName.inputValue}"*
*label="#{bindings.perInfoAll1.hints.lastName.label}"*
*required="#{bindings.perInfoAll1.hints.lastName.mandatory}"*
*columns="#{bindings.perInfoAll1.hints.lastName.displayWidth}"*
*maximumLength="#{bindings.perInfoAll1.hints.lastName.precision}"*
*shortDesc="#{bindings.perInfoAll1.hints.lastName.tooltip}"*
*id="it1">*
*<f:validator binding="#{row.bindings.lastName.validator}"/>*
*</af:inputText>*
*</af:column>*
*</af:table>*
*</af:form>*
*</af:document>*
*</f:view>*
but when run it i see the following errors
*Class oracle.adf.model.adapter.bean.BeanDataControl can not access a member of class nl.amis.hrm.EmpManager with modifiers "private"*
*Object EmpManager of type DataControl is not found.*
*java.lang.NullPointerException*
*Class oracle.adf.model.adapter.bean.BeanDataControl can not access a member of class nl.amis.hrm.EmpManager with modifiers "private"*
*Object EmpManager of type DataControl is not found.*
*java.lang.NullPointerException*
:(

View Object to read data from a java file

Hi,
I am using JDeveloper 11.1.1.4 and ADF-BC in my application.
For one of my view objects , I want the data to be read from a java file which exposes some method to return a collection.
I cannot use a static view object in this case.
Please suggest the best way to implement this requirement.Basically build a view object that should read data from a java file.
Thanks,
Praveen

Depending on your use case you can either use a programmatic VO or directly expose the JV class as a data control.
http://docs.oracle.com/cd/E18941_01/tutorials/jdtut_11r2_36/jdtut_11r2_36.html

Import statement in .java files and .jsp files

Guys I have few mysteries about this import statement.
Please correct me if I am wrong.
1)Suppose if I have a folder c:\SourceFolder it has one.java and two.java files.If I compile one.java then one.class files is created in c:\ClassFolder .Now two.java uses one of the method of one.java,and without using import statement I am able to compile two.java, and two.class file is created in c:\ClassFolder.I assume that the path of one.class was taken from the CLASSPATH environment variable,hence I there was no need for import statement .........am i right ?
BUT... in My.jsp,which is in C:\JspFolder, if I want to use one.class,then I have to specifically import the class I want to use.That is i have to say
<%@page import="one"%>
and since the classpath is C:\ClassFolder ,it finds one.class in the C:\ClassFolder.(Note that My.class is created in a folder different from c:\ClassFolder )
But I am wondering why was there no need for me to import one.class in two.java.
(Note I am using JDeveloper and Apache server)
Please help.
In this case the pSo I am wondering in JSP why it doesn't take the class I am looking for from the classpath .
Help.

You have to understand Java scoping rules. In the 1st scenario with the two Java files I am guessing neither one of them begins with a package statement. This means that they belong to the default package. When you compile the compiler uses the classpath to resolve method calls looking in the default package since there was no import statement specified in two.java. JSP is a little different. Now I just read this here in these forums a couple of days ago. Since the classfiles generated from the JSP files are not in the CLASSPATH they are loaded by a different classloader. This is why you have to import all references to all classes in the default package.

@(#) in Java file comment

Similar Messages

Maybe you are looking for