Phần này giới thiệu CsvDataSourceServlet
. CsvDataSourceServlet
là một phương thức triển khai mẫu sử dụng tệp CSV làm kho lưu trữ dữ liệu bên ngoài. Phần này cũng cung cấp hướng dẫn từng bước về cách chạy và kiểm thử CsvDataSourceServlet
.
Lưu ý: Bạn nên hoàn thành phần Bắt đầu với nguồn dữ liệu trước khi bắt đầu phần này.
Giới thiệu CsvDataSourceServlet
Lớp CsvDataSourceServlet
nằm trong gói examples
. Lớp này cung cấp phương thức triển khai mẫu sử dụng tệp CSV làm kho dữ liệu bên ngoài. CsvDataSourceServlet
kế thừa
từ DataSourceServlet
,
triển khai generateDataTable()
và phải chạy trong vùng chứa GVP.
Đoạn mã CsvDataSourceServlet
được cung cấp bên dưới. Hàm generateDataTable
hiển thị dữ liệu trong thư viện. Hàm này tạo một nội dung mô tả bảng dữ liệu, xác định các cột trong bảng dữ liệu và điền dữ liệu thu được từ tệp CSV. Tệp CSV được đọc từ một URL được chỉ định trong truy vấn của hình ảnh yêu cầu. Thư viện này xử lý
tất cả các hành động khác cần thiết để trả về bảng dữ liệu về hình ảnh trực quan truy vấn.
/** * A demo servlet for serving a simple, constant data table. * This servlet extends DataSourceServlet, but does not override the default * empty implementation of method getCapabilities(). This servlet therefore ignores the * user query (as passed in the 'tq' url parameter), leaving the * query engine to apply it to the data table created here. * * @author Nimrod T. */ public class CsvDataSourceServlet extends DataSourceServlet { /** * Log. */ private static final Log log = LogFactory.getLog(CsvDataSourceServlet.class.getName()); /** * The name of the parameter that contains the url of the CSV to load. */ private static final String URL_PARAM_NAME = "url"; /** * Generates the data table. * This servlet assumes a special parameter that contains the CSV URL from which to load * the data. */ @Override public DataTable generateDataTable(Query query, HttpServletRequest request) throws DataSourceException { String url = request.getParameter(URL_PARAM_NAME); if (StringUtils.isEmpty(url)) { log.error("url parameter not provided."); throw new DataSourceException(ReasonType.INVALID_REQUEST, "url parameter not provided"); } Reader reader; try { reader = new BufferedReader(new InputStreamReader(new URL(url).openStream())); } catch (MalformedURLException e) { log.error("url is malformed: " + url); throw new DataSourceException(ReasonType.INVALID_REQUEST, "url is malformed: " + url); } catch (IOException e) { log.error("Couldn't read from url: " + url, e); throw new DataSourceException(ReasonType.INVALID_REQUEST, "Couldn't read from url: " + url); } DataTable dataTable = null; ULocale requestLocale = DataSourceHelper.getLocaleFromRequest(request); try { // Note: We assume that all the columns in the CSV file are text columns. In cases where the // column types are known in advance, this behavior can be overridden by passing a list of // ColumnDescription objects specifying the column types. See CsvDataSourceHelper.read() for // more details. dataTable = CsvDataSourceHelper.read(reader, null, true, requestLocale); } catch (IOException e) { log.error("Couldn't read from url: " + url, e); throw new DataSourceException(ReasonType.INVALID_REQUEST, "Couldn't read from url: " + url); } return dataTable; } }
Chạy và thử nghiệm CsvDataSourceServlet
Phần này cung cấp hướng dẫn về cách chạy và kiểm thử CsvDataSourceServlet
.
Để chạy và kiểm thử CsvDataSourceServlet
, hãy tạo một tệp CSV, cập nhật ứng dụng web và thiết lập hình ảnh để truy vấn nguồn dữ liệu như được mô tả trong các phần sau:
Tạo tệp CSV
Tệp csv_example.csv
được cung cấp trong thư mục <data_source_library_install>/examples/src/html
.
Thư viện này bao gồm các giá trị sau:
Employee,Manager Roger,John Robert,John Jane,Roger Jack,Jane Bob,Jane
Sao chép tệp này vào thư mục <tomcat_home>/webapps/myWebApp
bạn đã tạo trong phần Bắt đầu.
Cập nhật ứng dụng web của bạn trên Apache Tomcat
Hãy làm theo hoặc điều chỉnh hướng dẫn dưới đây để cập nhật ứng dụng web của bạn trên Apache Tomcat. Hướng dẫn dành riêng cho Apache Tomcat trên hệ thống Windows:
- Tệp
web.xml
mà bạn từng sao chép vào thư mụcWEB-INF
đã chứa định nghĩa và mục ánh xạ cần thiết cho ví dụ này. Các dòng xác định điều này là:
<servlet> <servlet-name>CSV Example</servlet-name> <description> CsvDataSourceServlet </description> <servlet-class>CsvDataSourceServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>CSV Example</servlet-name> <url-pattern>/csv</url-pattern> </servlet-mapping>
- Khởi động Tomcat hoặc khởi động lại Tomcat nếu nó đang chạy.
- Nhấp vào đường liên kết sau:
http://localhost:8080/myWebApp/csv?url=http://localhost:8080/myWebApp/csv_example.csv
Màn hình sẽ hiển thị 6 đến 7 dòng văn bản, tùy thuộc vào chiều rộng màn hình.
Văn bản này bắt đầu bằnggoogle.visualization.Query.setResponse
và kết thúc bằng{c:[{v:'Bob'},{v:'Jane'}]}]}});
Đây là phản hồi mà nguồn dữ liệu CSV mẫu gửi đến một hình ảnh trực quan.
Sử dụng hình ảnh để xem dữ liệu
Bạn có thể dùng tệp all_examples.html
trong thư mục <data_source_library_install>/examples/src/html
để xem hình ảnh dữ liệu.
Nếu xem nguồn của tệp all_examples.html
, bạn sẽ thấy có 3 hình ảnh trực quan trong tệp. Các đoạn mã sau đây tái tạo quy cách của các hình ảnh trực quan này.
- Dòng sau đây chỉ định ví dụ về
csv
được đề cập trong phần này:
query = new google.visualization.Query('csv?url=http://localhost:8080/myWebApp/csv_example.csv');
Dòng sau đây chỉ định hình ảnh biểu đồ của tổ chức:var chart = new google.visualization.OrgChart(document.getElementById('csv_div'));
- Dòng sau đây chỉ định
simpleexample
được đề cập trong phần Bắt đầu:
var query = new google.visualization.Query('simpleexample?tq=select name,population');
Dòng sau đây chỉ định hình ảnh biểu đồ hình tròn:var chart = new google.visualization.PieChart(document.getElementById('simple_div'));
- Dòng sau đây chỉ định ví dụ về
advanced
được đề cập trong phần Xác định khả năng và Luồng sự kiện:
query = new google.visualization.Query('advanced?tableId=planets&tq=select planet,mass');
Dòng sau đây chỉ định hình ảnh biểu đồ thanh:var chart = new google.visualization.BarChart(document.getElementById('advanced_div'));
Để biết thêm thông tin về cách chỉ định biểu đồ và sử dụng ngôn ngữ truy vấn, hãy xem phần Giới thiệu về cách sử dụng các công cụ biểu đồ và Tài liệu tham khảo về ngôn ngữ truy vấn.
Hãy làm theo hoặc điều chỉnh các hướng dẫn dưới đây để xem hình ảnh dữ liệu mà CsvDataSourceServlet
phân phát:
- Sao chép tệp
all_examples.html
từ thư mục<data_source_library_install>/examples/src/html
vào thư mục<tomcat_home>/webapps/myWebApp/
. - Nhấp vào đường liên kết sau: http://localhost:8080/myWebApp/all_examples.html, bạn sẽ thấy hình ảnh trực quan sau.
Ví dụ về Nguồn dữ liệu nâng cao được thảo luận trong phần Xác định khả năng và luồng sự kiện.
Bước tiếp theo
Ví dụ tiếp theo được mô tả trong phần Xác định khả năng và luồng sự kiện. Ngoài ra, hãy khám phá các đường liên kết sau:
- Để biết thông tin giới thiệu về các lớp được sử dụng phổ biến nhất của thư viện, hãy xem Lớp chính.
- Thay vì để nguồn dữ liệu kế thừa từ
DataSourceServlet
, bạn có thể kế thừa nguồn dữ liệu này từ một lớp khác. Để biết thêm thông tin, hãy xem nội dung Sử dụng dịch vụ của riêng bạn. - Để tìm hiểu cách truyền tham số từ một ứng dụng đến nguồn dữ liệu, hãy xem bài viết Truyền tham số đến
DataTableGenerator.generateDataTable
.