Ho una classe che ha un sacco di funzioni e non posso dividerla in più classi:
Class A {
// attributes
/**
* Descriptive of foo
*
* @param i ...
* @param j ...
*/
public void foo(int i, double j) {
....
}
// doc for foo2
public void foo2() {
....
}
....
// doc for foo8
public void foo8() {
....
}
}
La domanda è, è una buona pratica implementare un'interfaccia che si occuperà dei commenti?
/**
* No function bodies, so there is more place here !
*/
interface AHelper {
/**
* Descriptive of foo
*
* @param i ...
* @param j ...
*/
public void foo(int i, int j);
// etc
}
/**
*
* @see A
*/
class A implements AHelper {
public void foo(int i, int j) {
....
}
// etc
}
In questo modo, l'interfaccia ha lo stesso aspetto delle intestazioni C. L'idea alla base di questo è avere due file con circa ~ 150 righe e non un singolo file (la classe) con 300 righe.