Discussion :

[Chavadam]

Bonjour et bonne humeur à tous.

(Je suis surpris de ne pas trouver de sous-forum dédicacé à JFreeChart ...)

Dans l'application que je construis, je projette d'utiliser JFreeChart (v.1.0.10 que j'ai autrefois achetée) pour obtenir un graphique à quatre séries de données (pouvant être discontinues). Je mets donc en oeuvre un "dataset" de la classe 'TimeSeriesCollection' ainsi qu'un graphique

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

JFreeChart chart = ChartFactory.createTimeSeriesChart

Dans mon IDE de NetBeans (v.7.3.1), apparaît bien la librairie 'JFreeChart - jfreechart-1.0.10.jar'. J'en déduisais que la Javadoc était intégralement installée

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
JFreeChart - jfreechart-1.0.10.jar
        ...
        org.jfree.data.time
                ...
                TimeSeriesCollection
                        ...
                        getDomainIsPointsInTime() : boolean
        ...

à tort - voir les fonctions barrées.
(Je n'ai encore jamais utilisé Marven, comme le conseille l'excellent Thierry Leriche-Dessirier, n'en comprenant pas encore bien l'utilité et le trouvant bien compliqué.)
Je ne dispose que du document-papier 'Developer Guide' de David Gilbert - version 1.0.5 du 23 Mars 2007, dont le chapitre 8 est consacré à 'Time Series Chart'.
Dans l'exemple donné figure bien entendu la fonction 'private static JFreeChart createChart(XYDataset dataset)(...)' ainsi que la fonction

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
    private static XYDataset createDataset()
    {
        TimeSeries s1 = new TimeSeries("Heures pleines", Month.class);
        s1.add(new Month(2, 2012), 181.8);
        ...
 
        TimeSeriesCollection dataset = new TimeSeriesCollection();
        dataset.addSeries(s1);
        ...
 
        dataset.setDomainIsPointsInTime(true);		// Fonction automatiquement barrée !
        return dataset;
    }

Mais dans celle-ci figure un appel à la fonction de librairie 'dataset.setDomainIsPointsInTime(true);'. Le "précompilateur" barre automatiquement cette fonction, prétextant

Javadoc not found. Either Javadoc documentation for this item does not exist or there is no attached Javadoc to the JAR file containing this item: C:\Java libraries\jfreechart-1.0.10.jar

Cette fonction est donc l'une des rares pour lesquelles la Javadoc n'a pas été intégrée. Je n'en comprends pas bien la raison. Apparemment, il s'agit d'une fonction simplement non documenté et pré-compilée, probablement pour en cacher le code source, mais qui fonctionne complètement. Y a-t-il des désavantages ou des choses à savoir ?
Une âme empatique pourrait-elle me le dire ?
Merci d'avance.

[sinok]

Elle est tout simplement dépréciée et son usage n'est donc pas recommandé.

Cf javadoc: http://www.jfree.org/jfreechart/api/...InTime:boolean


Et pour avoir uen javadoc locale:

You can generate a local copy of the API documentation using the Ant script included in the JFreeChart distribution. Just type 'ant javadoc' (assuming that you have Ant correctly installed).

http://www.jfree.org/jfreechart/api.html

[Chavadam]

Merci pour ta réponse, Sinok.

Non seulement ma version de software JFreeChart est âgée (v.1.0.10), mais mon 'Developer Guide', d'où je tire cette "instruction dépassée" l'est aussi (23 mars 2007), et celle-ci concerne même la v.1.0.5

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

dataset.setDomainIsPointsInTime(true);

Existe-t-il chez JFreeChart une Javadoc disponible en browser ou un autre moyen pour savoir par quelle(s) instruction(s) la remplacer sans devoir acheter un récent et volumineux 'Developer Guide' qui ne parlerait même plus de JFreeChart v.1.0.10 ?

Merci d'avance.

[sinok]

Non, mais, euh. As tu vu le lien que je t'ai donné au dessus?

[Chavadam]

Bonjour à tous.
Oui, Sinok, j'ai vu le lien bien intéressant vers la Javadoc de JFreeChart 1.0.17 et n'ai toujours pas terminé d'en faire le tour.
Notemment : http://www.jfree.org/jfreechart/api/javadoc/index.html
Merci bcp.