2013-02-21 12 views
8

Pracuję z Eclipse w Javie i przy długich długich klasach potrzebuję funkcji podobnej do tej: w górnym komentarzu metody (na przykład) znajduje się lista wykonanych operacji według metody. Dla każdej wymienionej operacji chciałbym "hiperlinkować" część komentarza do określonej linii powiązanego kodu.Pisanie komentarza w Eclipse łączącego konkretną linię

Następnie za pomocą Ctrl + Kliknij, aby przeskoczyć bezpośrednio do określonego kodu linii.

Czy możliwa jest taka operacja?

Dzięki

+1

Jestem prawie pewny, że możesz łączyć się tylko z metodami (np. Tymi, które wywołujesz), aby nie kodować wewnątrz metod. –

+3

"Lista operacji" brzmi trochę, jeśli każda "operacja" jest kandydatem do * wyodrębniania do metody * refaktoryzacji. Dlaczego chciałbyś komentować w metodzie-komentarz związanej z decyzjami związanymi z implementacją w ramach metody (mogą one ulec zmianie bez zmiany funkcjonalności metody)? – MrSmith42

+0

@ MrSmith42 masz rację, mogę używać różnych metod, ale jak mówi kw4nta, jak mogę połączyć metody? –

Odpowiedz

1

Można użyć tagu JavaDoc @see:

/** 
* @see MyClass#myMethod() 
*/ 

Generuje hiperłącza w swojej JavaDoc.

SRC: method-linking-anchoring-in-java

+1

Działa tylko na * poziomie *. Nie można łączyć z częściami w ramach metody. To było pytanie. – MrSmith42

+0

Dzięki tej notacji łącza są wyświetlane tylko w JavaDoc. Muszę używać tych linków bezpośrednio w źródłach kodu, takich jak Ctrl + Click –

+1

. W takim przypadku możesz użyć menedżera hiperłącza z eclipse, patrz http://help.eclipse.org/helios/index.jsp?topic=%2Forg .eclipse.platform.doc.isv% 2Freference% 2Fapi% 2Forg% 2Feclipse% 2Fjface% 2Ftext% 2Funkcja połączenia% 2FHyperlinkManager.html – Sabarish

0

Eclipse IDE pozwala przejść od wywołania metody do definicji metody badaniem ('F3' myślę).

Poza tym, nie sądzę, że istnieje sposób na skonfigurowanie "specjalnej" nawigacji. Pamiętaj, że jeśli potrzebujesz czegoś takiego, jest to mocna wskazówka, że ​​twoje metody są DUŻE zbyt duże. Zmodyfikuj je.


Myślenie poza pole, jeśli były, aby nakarmić swój kod za pomocą drukarki do kodu html-ładna, można osadzić hiperłącza HTML i kotwice w komentarzach (javadoc lub normalny). Przy odrobinie szczęścia można je kliknąć, gdy przeglądasz kod HTML z kodem źródłowym w przeglądarce.


Oczywiście Eclipse może śledzić "linki" javadoc. Oczywiście standardowe znaczniki nie mogą łączyć się z głębią wewnątrz metody, ale myślę, że można napisać plugin Eclipse, który obsługuje niestandardowe znaczniki javadoc do łączenia z osadzonymi kotwicami i ich nawigacji.

6

w komentarzu poniżej swoje pytanie mówisz:

jak mogę połączyć metody?

Spójrz na poniższy przykład: można nacisnąć ctrl + kliknij bar() w JavaDoc z foo() i zaćmienie skacze do sposobu bar().

public class Example { 

    /** 
    * JavaDoc of foo(). This method executes {@link Example#bar()} 
    */ 
    public void foo() { 
     bar(); 
    } 

    /** 
    * Javadoc of bar(). 
    */ 
    public void bar() { } 
} 

Eclipse oferuje nawet autouzupełniania dla @link, nazwę klasy i metody (po ręcznym wprowadzeniu #).

Czy tego właśnie szukasz?

Powiązane problemy