For me the `/**&lt;NEWLINE&gt;` or &lt;kbd&gt;Shift&lt;/kbd&gt;-&lt;kbd&gt;Alt&lt;/kbd&gt;-&lt;kbd&gt;J&lt;/kbd&gt; (or &lt;kbd&gt;⌘&lt;/kbd&gt;-&lt;kbd&gt;⌥&lt;/kbd&gt;-&lt;kbd&gt;J&lt;/kbd&gt; on a Mac) approach works best.

I dislike seeing Javadoc comments in source code that have been auto-generated and have not been updated with real content.  As far as I am concerned, such javadocs are nothing more than a waste of screen space.

IMO, it is much much better to generate the Javadoc comment skeletons one by one as you are about to fill in the details.  

`Shift-Alt-J` is a useful keyboard shortcut in Eclipse for creating Javadoc comment templates. 

Invoking the shortcut on a class, method or field declaration will create a Javadoc template:

    public int doAction(int i) {
    	return i;
    }

Pressing `Shift-Alt-J` on the method declaration gives:

    /**
     * @param i
     * @return
     */
    public int doAction(int i) {
    	return i;
    }



[JAutoDoc][1]:
&gt; an [Eclipse](http://www.eclipse.org/) Plugin for automatically adding Javadoc and file headers to your source code. It optionally generates initial comments from element name by using [Velocity](http://velocity.apache.org/) [templates](http://jautodoc.sourceforge.net/templates.html) for Javadoc and file headers...


  [1]: http://jautodoc.sourceforge.net/

You mean menu Project -&gt; Generate Javadoc   ?

At a place where you want javadoc, type in `/**`&amp;lt;NEWLINE&gt; and it will create the template.


I work for a school district. Every year we have to export a list of students from our student management system and send it to a company that handles our online exams.

So to do this export, we had to hire someone who knew the inner workings of our student management system. He wrote an sql (Adaptive Sybase SQL Anywhere) query to export the students to a csv file like we needed. This was before I started working for the district, so for a while I assumed this was an actually application, until it came time for me to do the export myself.

And every year he charges us $500 to update this query to export the students for the current year. So when I discovered it was only a query (.bat file and .sql file), my thought was &quot;I can update this myself&quot;. All I have to do is change the years in the query (eg. 2009 to 2010).

The query (.sql file) itself has this comment at the top:

    // This code was writtend by [the guy]
    // and is the property of [his company]...Copyright 2005,2006,2008,2009
    // This code MAY NOT BE USED without the expressed written consent of 
    // [his company].

(Yes, it really does says &quot;writtend&quot;.)

So now my boss is worried that we&#39;re violating the copyright. And that the guy is gonna find out that I updated the query myself because we haven&#39;t asked him to update it this year and take legal action.

So back to the subject&#39;s question:
Can he really copyright this query?
And if so, is modifying it ourselves a copyright violation?
In my mind, a single query isn&#39;t program code. It&#39;s more a command line command. But I don&#39;t know what it&#39;s considered legally.

Can someone copyright a SQL query?

I&#39;m aware of the `` `. `` command that goes to last edited line. Is there a way to go further in the editing history? I often accidentally insert something while browsing the file, undo, but then `` `. `` will not bring me where I want anymore.

How to go back to lines edited before the last one in Vim?

Is there a way to generate Javadoc comments in Eclipse? If so, what is it?

How can I generate Javadoc comments in Eclipse?

<p>Is there a way to generate Javadoc comments in Eclipse? If so, what is it?</p>


I have an interface with a method that expects an array of `Foo`:

    public interface IBar {
      void doStuff(Foo[] arr);
    }

I am mocking this interface using Mockito, and I&#39;d like to assert that `doStuff()` is called, but I don&#39;t want to validate what argument are passed - &quot;don&#39;t care&quot;.

How do I write the following code using `any()`, the generic method, instead of `anyObject()`?

    IBar bar = mock(IBar.class);
    ...
    verify(bar).doStuff((Foo[]) anyObject());


Using Mockito&#39;s generic &quot;any()&quot; method

Since [Spring][1] is able to use transactions just like [EJB][2]. For me, Spring is able to replace the requirement of using EJB. Can anyone tell me what are the extra advantages of using EJB? 


  [1]: http://en.wikipedia.org/wiki/Spring_Framework
  [2]: http://en.wikipedia.org/wiki/Enterprise_JavaBean

Spring vs EJB. Can Spring replace EJB?

I have a process A that contains a table in memory with a set of records (recordA, recordB, etc...)

Now, this process can launch many threads that affect the records, and sometimes we can have 2 threads trying to access the same record - this situation must be denied. Specifically if a record is LOCKED by one thread I want the other thread to abort (I do not want to BLOCK or WAIT).

Currently I do something like this:

    synchronized(record)
    {
    performOperation(record);
    }

But this is causing me problems ... because while Process1 is performing the operation, if Process2 comes in it blocks/waits on the synchronized statement and when Process1 is finished it performs the operation. Instead I want something like this:

    if (record is locked)
       return;

    synchronized(record)
    {
    performOperation(record);
    }

Any clues on how this can be accomplished?
Any help would be much appreciated.
Thanks,

How do determine if an object is locked (synchronized) so not to block in Java?

When I write a HQL query

    Query q = session.createQuery(&quot;SELECT cat from Cat as cat ORDER BY cat.mother.kind.value&quot;);
    return q.list();

Everything is fine. However, when I write a Criteria

    Criteria c = session.createCriteria(Cat.class);
    c.addOrder(Order.asc(&quot;mother.kind.value&quot;));
    return c.list();

I get an exception `org.hibernate.QueryException: could not resolve property: kind.value of: my.sample.data.entities.Cat`

If I want to use Criteria and Order, how should I express my &quot;order by&quot;?

ORDER BY using Criteria API

I have very simple persistance.xml file:

&lt;!-- language: xml --&gt;

    &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
    &lt;persistence version=&quot;1.0&quot;
    	xmlns=&quot;http://java.sun.com/xml/ns/persistence&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
    	xsi:schemaLocation=&quot;http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd&quot;&gt;
    
    	&lt;persistence-unit name=&quot;eventractor&quot; transaction-type=&quot;RESOURCE_LOCAL&quot;&gt;
    		&lt;class&gt;pl.michalmech.eventractor.domain.User&lt;/class&gt;
    		&lt;class&gt;pl.michalmech.eventractor.domain.Address&lt;/class&gt;
    		&lt;class&gt;pl.michalmech.eventractor.domain.City&lt;/class&gt;
    		&lt;class&gt;pl.michalmech.eventractor.domain.Country&lt;/class&gt;
    
    		&lt;properties&gt;
    			&lt;property name=&quot;hibernate.hbm2ddl.auto&quot; value=&quot;validate&quot; /&gt;
    			&lt;property name=&quot;hibernate.show_sql&quot; value=&quot;true&quot; /&gt;
    		&lt;/properties&gt;
    	&lt;/persistence-unit&gt;
    
    &lt;/persistence&gt;

and it works.

But when I remove `&lt;class&gt;` elements application doesn&#39;t see entities (all classes are annotated with `@Entity`).

Is there any automatic mechanism to scan for `@Entity` classes?

Do I need &lt;class&gt; elements in persistence.xml?

I am trying to generate an executable jar for a small home project called &quot;logmanager&quot; using maven, just like this:

[https://stackoverflow.com/questions/574594/how-can-i-create-an-executable-jar-with-dependencies-using-maven][1]

I added the snippet shown there to the pom.xml, and ran mvn assembly:assembly. It generates two jar files in logmanager/target: logmanager-0.1.0.jar, and logmanager-0.1.0-jar-with-dependencies.jar. I get an error when I double-click on the first jar:

    Could not find the main class: com.gorkwobble.logmanager.LogManager. Program will exit.

A slightly different error when I double-click the jar-with-dependencies.jar:

    Failed to load Main-Class manifest attribute from: C:\EclipseProjects\logmanager\target\logmanager-0.1.0-jar-with-dependencies.jar

I copied and pasted the path and classname, and checked the spelling in the POM. My main class launches fine from an eclipse launch configuration. Can someone help me figure out why my jar file won&#39;t run? Also, why are there two jars to begin with? Let me know if you need more information.


  [1]: https://stackoverflow.com/questions/574594/how-can-i-create-an-executable-jar-with-dependencies-using-maven

Here is the full `pom.xml`, for reference:

&lt;!-- language: xml --&gt;

    &lt;project xmlns=&quot;http://maven.apache.org/POM/4.0.0&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:schemaLocation=&quot;http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd&quot;&gt;
      &lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
      &lt;groupId&gt;com.gorkwobble&lt;/groupId&gt;
      &lt;artifactId&gt;logmanager&lt;/artifactId&gt;
      &lt;name&gt;LogManager&lt;/name&gt;
      &lt;version&gt;0.1.0&lt;/version&gt;
      &lt;description&gt;Systematically renames specified log files on a scheduled basis. Designed to help manage MUSHClient logging and prevent long, continuous log files.&lt;/description&gt;
      &lt;build&gt;
      	&lt;plugins&gt;
      		&lt;plugin&gt;
    			&lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
    		    &lt;artifactId&gt;maven-jar-plugin&lt;/artifactId&gt;
    		    &lt;version&gt;2.2&lt;/version&gt;
    		    &lt;!-- nothing here --&gt;
    		&lt;/plugin&gt;
    		&lt;plugin&gt;
    		    &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
    		    &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
    		    &lt;version&gt;2.2-beta-4&lt;/version&gt;
    		    &lt;configuration&gt;
    		      &lt;descriptorRefs&gt;
    		        &lt;descriptorRef&gt;jar-with-dependencies&lt;/descriptorRef&gt;
    		      &lt;/descriptorRefs&gt;
    		      &lt;archive&gt;
    		        &lt;manifest&gt;
    		          &lt;mainClass&gt;com.gorkwobble.logmanager.LogManager&lt;/mainClass&gt;
    		        &lt;/manifest&gt;
    		      &lt;/archive&gt;
    		    &lt;/configuration&gt;
    		    &lt;executions&gt;
    		      &lt;execution&gt;
    		        &lt;phase&gt;package&lt;/phase&gt;
    		        &lt;goals&gt;
    		          &lt;goal&gt;single&lt;/goal&gt;
    		        &lt;/goals&gt;
    		      &lt;/execution&gt;
    		    &lt;/executions&gt;
    		  &lt;/plugin&gt;
    		  &lt;plugin&gt;
    		    &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
    		    &lt;artifactId&gt;maven-compiler-plugin&lt;/artifactId&gt;
    		    &lt;configuration&gt;
    		      &lt;source&gt;1.6&lt;/source&gt;
    		      &lt;target&gt;1.6&lt;/target&gt;
    		    &lt;/configuration&gt;
    		  &lt;/plugin&gt;
      	&lt;/plugins&gt;
      &lt;/build&gt;
      &lt;dependencies&gt;
      	&lt;!-- commons-lang --&gt;
      	&lt;dependency&gt;
        	&lt;groupId&gt;commons-lang&lt;/groupId&gt;
        	&lt;artifactId&gt;commons-lang&lt;/artifactId&gt;
        	&lt;version&gt;2.4&lt;/version&gt;
        &lt;/dependency&gt; 
      
      	&lt;!-- Quartz scheduler --&gt;
      	&lt;dependency&gt;
      		&lt;groupId&gt;opensymphony&lt;/groupId&gt;
      		&lt;artifactId&gt;quartz&lt;/artifactId&gt;
      		&lt;version&gt;1.6.3&lt;/version&gt;
      	&lt;/dependency&gt;
      	&lt;!-- Quartz 1.6.0 depends on commons collections --&gt;
        &lt;dependency&gt;
          &lt;groupId&gt;commons-collections&lt;/groupId&gt;
          &lt;artifactId&gt;commons-collections&lt;/artifactId&gt;
          &lt;version&gt;3.1&lt;/version&gt;
        &lt;/dependency&gt;
        &lt;!-- Quartz 1.6.0 depends on commons logging --&gt;
        &lt;dependency&gt;
          &lt;groupId&gt;commons-logging&lt;/groupId&gt;
          &lt;artifactId&gt;commons-logging&lt;/artifactId&gt;
          &lt;version&gt;1.1&lt;/version&gt;
        &lt;/dependency&gt;
        &lt;!-- Quartz 1.6.0 requires JTA in non J2EE environments --&gt;
        &lt;dependency&gt;
          &lt;groupId&gt;javax.transaction&lt;/groupId&gt;
          &lt;artifactId&gt;jta&lt;/artifactId&gt;
          &lt;version&gt;1.1&lt;/version&gt;
          &lt;scope&gt;runtime&lt;/scope&gt;
        &lt;/dependency&gt;
        
        &lt;!-- junitx test assertions --&gt;
        &lt;dependency&gt;
    	    &lt;groupId&gt;junit-addons&lt;/groupId&gt;
    	    &lt;artifactId&gt;junit-addons&lt;/artifactId&gt;
    	    &lt;version&gt;1.4&lt;/version&gt;
    	    &lt;scope&gt;test&lt;/scope&gt;
    	&lt;/dependency&gt;
    	
    	&lt;!-- junit dependency; FIXME: make this a separate POM --&gt;
    	&lt;dependency&gt;
          &lt;groupId&gt;junit&lt;/groupId&gt;
          &lt;artifactId&gt;junit&lt;/artifactId&gt;
          &lt;version&gt;4.1&lt;/version&gt;
        &lt;/dependency&gt;
      	
      &lt;/dependencies&gt;
      &lt;dependencyManagement&gt;
      &lt;/dependencyManagement&gt;
    &lt;/project&gt;



Building executable jar with maven?

I&#39;ve got some Java code with SQL statements written as Java strings (please no OR/M flamewars, the embedded SQL is what it is - not my decision).

I&#39;ve broken the SQL statements semantically into several concatenated strings over several lines of code for ease of maintenance. So instead of something like:

    String query = &quot;SELECT FOO, BAR, BAZ FROM ABC WHERE BAR &gt; 4&quot;;

I have something like:

    String query =
        &quot;SELECT FOO, BAR, BAZ&quot; +
        &quot;  FROM ABC          &quot; +
        &quot; WHERE BAR &gt; 4      &quot;;

This style makes the SQL much easier to read and maintain (IMHO), especially for larger queries. For example, I can put my editor into &quot;overwrite&quot; mode and modify the text in-place fairly easily.

**Note that this issue generalizes beyond the particular example of SQL. Any code that is written with any vertical formatting, particularly tabular constructs, is susceptible to destruction by a pretty printer.**

Now, some project members use the Eclipse editor and the semantic formatting is often destroyed when they format an entire source file.

**Is there a way to instruct Eclipse to ignore certain lines of source with respect to formatting?**

I&#39;m looking for something like a special comment that toggles the Eclipse formatter. Ideally, such a comment could be configurable to be whatever we choose, and other formatters could be programmed to respect it as well:

    // STOP-ECLIPSE-FORMATTING
    String query =
        &quot;SELECT FOO, BAR, BAZ&quot; +
        &quot;  FROM ABC          &quot; +
        &quot; WHERE BAR &gt; 4      &quot;;
    // START-ECLIPSE-FORMATTING

Obviously, one &quot;solution&quot; is to have our team members standardize on some external formatter like [Jalopy](http://www.triemax.com/products/jalopy/) or [JIndent](http://www.jindent.com/), but that&#39;s not what this question is about (also, not my decision on this project): I&#39;m specifically looking for a way to avoid the Eclipse formatter on an ad-hoc basis.

Ideally, a solution will allow me to insert instructions for the Eclipse formatter **without requiring team members using Eclipse to do any IDE reconfiguration** (other than possibly choosing a formatter agnostic command comment: `STOP-ECLIPSE-FORMATTING` &amp;rarr; `STOP-FORMATTING`).


How to turn off the Eclipse code formatter for certain sections of Java code?

Let&#39;s say I have a file with 10 lines and I have a problem with the name of the package (or something) and the cursor is on the last line of the text. 

How can I go directly to that line to see what the problem is and what suggestions there are to remove the problem, using a shortcut?


Question: Is there a keyboard-shortcut for this? 

Or something like this: 

*Go to the next error* and *Go to the previous error*.


How to go to an error using only the keyboard in Eclipse?

I have the eclipse CDT installed, and I would like to install Java development functionality (JDT) on top of my CDT installation. I&#39;ve been Googling from an hour but I can&#39;t figure out how to do this. 

What plugin do I need to install? What update site do I need to use?

Install Eclipse JDT on top of CDT

I had to move my Eclipse workspace from Linux to Windows when my desktop crashed. A week later I copy it back to Linux, code happily, commit to CVS. And alas, windows newlines have polluted many files, so CVS diff dumps the entire file, even when I changed a line or two!

I could cook up a script, but I am wondering if it will mess up my Eclipse project files.




Eclipse and Windows newlines

Is it possible to set up Intellij to generate javadoc for methods and classes, automatically, with @author and @since date? I had this feature in Eclipse. 

I know that the files have templates and also I can manually semi-automatically add javadoc to selected method/class. But I want the generation to be automatic for every generated method/class/enum/interface/field etc. 

This is useful for e.g. &quot;extract method&quot;, &quot;override/implement&quot;, &quot;create getter/setter&quot; etc. This would save hundreds of manual actions.

I&#39;m using IntelliJ Idea 9.0 BETA Community Edition, #IC-90.96.

Intellij generate javadoc for methods and classes

I&#39;ve been looking through the javadoc documentation on Sun&#39;s site, trying to find if there&#39;s a javadoc tag which can be used to document a class or method&#39;s generic type signature.

Something like `@typeparam`, similar to the usual `@param`, but applicable to types as well as methods,e.g.

    /**
     *  @typeparam T This describes my type parameter
     */
    class MyClass&lt;T&gt; {
    }

I suspect there is no such tag - I can find no mention of it anywhere, and the JavaSE API docs don&#39;t show any sign of it, but it seems like an odd omission. Can someone put me right?


Is there a javadoc tag for documenting generic type parameters?

I often find myself with a dilemma when writing javadoc for properties/members of a &quot;simple&quot; POJO class holding only properties and getters and setters (DTO-style)....

1) Write javadoc for the property  
or...  
2) Write javadoc for the getter  

If I write javadoc for the property, my IDE (Eclipse) will (naturally) not be able to display this when I later access the POJO via code completion. And there is no standard javadoc tag that lets me link the getter-javadoc to the actual property javadoc.

An example:

    public class SomeDomainClass {
        
      /**
       * The name of bla bla bla
       */
      private String name;
        
      /**
       * @return INSERT SOME SMART JAVADOC TAG LINKING TO name&#39;s javadoc
       */
      public String getName() {  
        return name;  
      }  


So, basically it would be interesting to hear how others go about for having your Eclipse IDE display the javadoc property description for your getters - without having to duplicate the javadoc comment.

As of now I&#39;m considering making my practise to only document the getters and not the properties. But it doesn&#39;t seem like the best solution...


How to write Javadoc of properties?

How can I escape the `@` symbol in javadoc? I am trying to use it inside a `{@code}` tag, which is inside `&lt;pre&gt;` tags.

I already tried the html escape `&amp;#64;` sequence, but that didn&#39;t work.

How can you escape the @ character in javadoc?

I&#39;m developing an API with many identically named methods that just differ by signature, which I guess is fairly common. They all do the same thing, except that they initialize various values by defaults if the user does not want to specify. As a digestible example, consider

    public interface Forest
    {
      public Tree addTree();
      
      public Tree addTree(int amountOfLeaves);
      
      public Tree addTree(int amountOfLeaves, Fruit fruitType);
      
      public Tree addTree(int amountOfLeaves, int height);
      
      public Tree addTree(int amountOfLeaves, Fruit fruitType, int height);
    }

The essential action performed by all of these methods is the same; a tree is planted in the forest. Many important things users of my API need to know about adding trees hold for all these methods.

Ideally, I would like to write one Javadoc block that is used by all methods:

      /**
       * Plants a new tree in the forest. Please note that it may take
       * up to 30 years for the tree to be fully grown.
       *
       * @param amountOfLeaves desired amount of leaves. Actual amount of
       * leaves at maturity may differ by up to 10%.
       * @param fruitType the desired type of fruit to be grown. No warranties
       * are given with respect to flavour.
       * @param height desired hight in centimeters. Actual hight may differ by
       * up to 15%.
       */

In my imagination, a tool could magically choose which of the @params apply to each of the methods, and thus generate good docs for all methods at once.

With Javadoc, if I understand it correctly, all I can do is essentially copy&amp;paste the same javadoc block five times, with only a slightly differing parameter list for each method. This sounds cumbersome to me, and is also difficult to maintain.

Is there any way around that? Some extension to javadoc that has this kind of support? Or is there a good reason why this is not supported that I missed?

Content Type	Original Author	Original Content on Stackoverflow
Question	antony.trupe	View Question on Stackoverflow
Solution 1 - Java	Stephen C	View Answer on Stackoverflow
Solution 2 - Java	coobird	View Answer on Stackoverflow
Solution 3 - Java	antony.trupe	View Answer on Stackoverflow
Solution 4 - Java	Mirek Pluta	View Answer on Stackoverflow
Solution 5 - Java	bmargulies	View Answer on Stackoverflow

How can I generate Javadoc comments in Eclipse?

Java Problem Overview

Java Solutions

Solution 1 - Java

Solution 2 - Java

Solution 3 - Java

Solution 4 - Java

Solution 5 - Java

How to go back to lines edited before the last one in Vim?

Can someone copyright a SQL query?

Attributions