Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, Google Görselleştirme Java kitaplığının nasıl kullanılacağı veya değiştirileceği ve proje için açık kaynak koduna nasıl katkıda bulunulacağı açıklanmaktadır.
Not: JDK 5.0 sürümünü de kullanmak mümkündür. Ancak daha sonra @Override hizmetini kitaplıkta bulunan ve bir arayüz yöntemini geçersiz kılan tüm yöntemlerden kaldırmanız gerekir. Bunun nedeni, JDK sürüm 6.0'da @Override ek açıklaması davranışındaki değişikliktir.
Bağımlılıklar
Veri kaynağı Java kitaplığı aşağıdaki bağımlılıklara sahiptir. Kitaplık, listelenen sürümlerle test edildi. Diğer sürümler kabul edilebilir olsa da test edilmemiştir.
Javacc 4.2 sürümü hakkında daha fazla bilgi edinin.
Bu işlem yalnızca kitaplıkları derlemeyi amaçlıyorsanız (örneğin, aşağıda açıklandığı gibi değiştirirken) gereklidir.
opencsv 1.8 sürümü Bu yalnızca bir CSV veri kaynağı kullanmayı planlıyorsanız gereklidir.
Kaynağa veya indirmeye dahil edilmeyen veriler:
SqlDataSourceHelper sınıfını mySQL veritabanıyla kullanmak için çalışma zamanı ortamınızda mysql.jar ürününe de ihtiyacınız vardır. Ayrıntılar ve indirilebilir sürümler için http://www.mysql.com/products/connector/j/ adresine göz atın.
Kitaplığı sağlandığı şekilde kullanma
Bu bölümde, değişiklik yapmanız gerekmiyorsa görselleştirme Java kitaplığını nasıl kullanacağınız açıklanmaktadır. Bu işlem, derleme sisteminize göre değişir:
Maven kullanıyorsanız aşağıdaki ayarlarla görselleştirme kitaplığında bağımlılık oluşturun:
Grup kimliği: com.google.Visualization
Yapı kimliği: görselleştirme-veri kaynağı
Sürüm numarası: Proje sayfasında listelenen en son sürüm numarasını kullanın.
Başka bir derleme sistemi kullanıyorsanız:
Proje sayfasından kitaplık ZIP dosyasını indirin, zip dosyalarını açın ve derleme sisteminizin gerektirdiği şekilde projenize ekleyin.
Örnekleri Çalıştırma
JAR örnek dosyaları, indirilebilir ZIP dosyasındaki kitaplık JAR'larla birlikte eklenir. Örneklerin çalıştırılmasıyla ilgili talimatlar Başlarken sayfasında verilmiştir.
Kitaplıkta değişiklik yapma
Kitaplık kodunda değişiklik yapmak isterseniz açık kaynak barındırma sitesinden kaynağı indirip oluşturmanız gerekir. Bu işlemi yapmadan önce, kullanım alanınıza izin verilip verilmediğini görmek için proje sayfasındaki "Kod lisansı" bölümünde bağlantısı verilen lisans bilgilerini okuyun.
Kitaplığı indirme ve oluşturma adımları şunlardır:
Kodunuzu oluşturun. Maven'de derliyorsanız kaynakla birlikte sağlanan pom.xml dosyasını kullanın. Apache Ant ile derleme yapıyorsanız sonraki talimatları uygulayın (kodun Ant 1.7.0 sürümü ile test edildiğini unutmayın. Ant'ın daha eski bir sürümüne sahipseniz yeni sürüme geçmeniz gerekebilir)
Karınca Oluşturma Talimatları
1. Derleme özelliklerinizi değiştirin:
Seçtiğiniz yükleme dizininin build-src alt dizinine gidin.
Metin düzenleyici kullanarak build.properties dosyasını açın ve
aşağıdaki değişiklikleri yapın:
servlet-api.jar özelliğini, servlet-api.jar dosyanıza işaret edecek şekilde düzenleyin.
Örneğin, tomcat_home dizinindeki c: sürücünüze Tomcat'i yüklediyseniz servlet-api.jar özelliğini şu şekilde belirtirsiniz: servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar
Not: Windows kullanılırken bile dosya yolunda ters eğik çizgi yerine düz eğik çizgi kullanın
Yukarıda açıklanan bağımlılıkların kendi kopyalarınızı kullanmak için yolları aynı derleme.properties dosyasında düzenleyin.
2. Kitaplığı oluşturma:
Dosyadaki build-src alt dizinine gidin ve aşağıdakilerden birini yazın:
ant datasource - Veri kaynağı kitaplığını oluşturur
ant example - Örnekleri oluşturur
ant - Hem veri kaynağı hem de örnekler oluşturur
ant test: Veri kaynağı kitaplığı testlerini oluşturur ve çalıştırır.
Kitaplığı değiştirirken çok kullanışlıdır.
Açık Kaynak Projesi'ne Katkıda Bulunma
Açık kaynak projesinde yapılan değişikliklere katkıda bulunmak istiyorsanız proje için gönderim izinlerini almanız gerekir. google-visualization-api@googlegroups.com adresine e-posta gönderin ve değişikliklerin nasıl gönderileceği ile ilgili izin ve talimatları isteyin.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2024-07-10 UTC."],[[["\u003cp\u003eThis documentation guides you on utilizing and extending the Google Visualization Java library for incorporating interactive charts into your applications.\u003c/p\u003e\n"],["\u003cp\u003eIt outlines prerequisites, dependencies, and steps for utilizing the library directly or modifying it to suit your specific needs.\u003c/p\u003e\n"],["\u003cp\u003eInstructions are provided for building the library from source and running included examples for a hands-on understanding.\u003c/p\u003e\n"],["\u003cp\u003eFor those interested in contributing to the project, guidance is offered on seeking permissions and submitting changes to the open-source codebase.\u003c/p\u003e\n"]]],[],null,["# Installing the Data Source Java Library\n\nThis page describes how to use or modify the Google Visualization Java library,\nand how to contribute to the open source code for the project.\n\nContents\n--------\n\n1. [Requirements](#requirements)\n2. [Dependencies](#dependencies)\n3. [Using the Library as Provided](#usingthelibrary)\n4. [Running the Examples](#buildingexamples)\n5. [Modifying the Library](#build_self)\n6. [Contributing to the Open Source Project](#contributing)\n\nRequirements\n------------\n\nYou must have the following components in order to use the Google Visualization\nJava library:\n\n- A servlet container and the Servlet API version 2.4 or higher. One of the most commonly used servlet containers is Apache Tomcat, which includes the Servlet API. See \u003chttp://tomcat.apache.org/download-55.cgi\u003e to download the binary for version 5.5. You need install only the Core module. You also need Tomcat to complete the tutorial sections: [Getting\n Started](/chart/interactive/docs/dev/dsl_get_started), [Using an External Data Store](/chart/interactive/docs/dev/dsl_csv), and [Defining\n Capabilities and the Flow of Events](/chart/interactive/docs/dev/dsl_httpservlet).\n- The [Java Development Kit](http://java.sun.com/) version 6.0 or greater.\n\n **Note** : It is also possible to use the JDK\n version 5.0. However, you must then remove `@Override` from\n every method in the library that overrides an interface method. This is\n due to the change in the `@Override` annotation behavior in\n JDK version 6.0.\n\nDependencies\n------------\n\nThe data source Java library has the following dependencies. The library was\ntested with the versions listed; other versions might be acceptable, but have not\nbeen tested.\n\n**Included in the source or download:**\n\n- [icu4j](http://site.icu-project.org/) version 4.0.1.\n- [Jakarta commons lang](http://commons.apache.org/lang/) version 2.4.\n- [Jakarta commons logging](http://commons.apache.org/logging/) version 1.1.1.\n- [Google collections\n library](http://code.google.com/p/google-collections/) version 1.0.\n- [*javacc*](https://javacc.dev.java.net/) version 4.2. This is required only if you intend to compile the libraries, for example when modifying them as described [below](#build_self).\n- [*opencsv*](http://opencsv.sourceforge.net/) version 1.8. This is required only if you intend to use a CSV data source.\n\n**Not included in the source or download:**\n\n- To use the `SqlDataSourceHelper` class with a mySQL database, you also need `mysql.jar` in your runtime environment. See: \u003chttp://www.mysql.com/products/connector/j/\u003e for details and downloadable versions.\n\nUsing the Library as Provided\n-----------------------------\n\nThis section describes how to use the visualization Java library if you don't\nneed to modify it. This process varies with your build system:\n\n**If using [Maven](http://maven.apache.org/index.html),** set\nup a dependency on the visualization library with the following settings:\n\n- Group ID: com.google.visualization\n- Artifact ID: visualization-datasource\n- Version number: Use the latest version number listed on the [project\n page](http://code.google.com/p/google-visualization-java/).\n\n**If using any other build system**:\n\n- [Download\n the library ZIP file](http://code.google.com/p/google-visualization-java/) from the project page, unzip the files, and include them in your project as your build system requires.\n\nRunning the Examples\n--------------------\n\nThe JAR example files are included along with the library JARs in the [downloadable\nZIP file](http://code.google.com/p/google-visualization-java/). Instructions on running the examples are given on the [Getting\nStarted](/chart/interactive/docs/dev/dsl_get_started) page.\n\nModifying the Library\n---------------------\n\nIf you want to modify the library code, you'll have to download the source from\nthe open source hosting site and build it. Before doing this, read the licensing\ninformation linked to by the \"Code license\" section on the [project\npage](http://code.google.com/p/google-visualization-java/) to see whether your use case is allowed.\n\nHere are the steps for downloading and building the library:\n\n1. **Download the source code** using SVN, as described in on the **Source \\\u003e Checkout** tab on the [open\n source project page](http://code.google.com/p/google-visualization-java/source/checkout).\n2. **Build your code.** If building in Maven, use the pom.xml file provided with the source. If building with [Apache\n Ant](http://ant.apache.org/), follow the instructions given next (note that the code has been tested with Ant version 1.7.0; if you have an earlier version of Ant, you might need to upgrade)\n\n### Ant Build Instructions\n\n**1. Modify your build properties:**\n\n1. Navigate to the `build-src` subdirectory of your chosen installation directory.\n2. Using a text editor, open the `build.properties` file and make the following changes:\n - Edit the `servlet-api.jar` property to point to your `servlet-api.jar` file. For example, if you installed Tomcat to your `c:` drive in the `tomcat_home` directory, then you would specify the `servlet-api.jar` property as follows: \n `servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar`\n\n **Note**: Use forward slashes rather than\n backslashes in the file path, even when using Windows\n - To use your own copies of the dependencies described above, edit the paths in the same build.properties file.\n\n**2. Build the library:**\n\nNavigate the `build-src` subdirectory in the file and type one of the\nfollowing:\n\n- `ant datasource` - Builds the data source library\n- `ant example` - Builds the examples\n- `ant` - Builds both data source and examples\n- `ant test` - Builds and runs the data source library tests. Very useful when you are modifying the library.\n\nContributing to the Open Source\nProject\n---------------------------------------\n\nIf you want to contribute changes to the open source project, you'll have to get\nsubmission permissions to the project. Send an email to [google-visualization-api@googlegroups.com](mailto:google-visualization-api@googlegroups.com) asking\nfor permission and instructions on how to submit changes."]]
