You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

GridConnector.java 47KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315
  1. /*
  2. * Copyright 2000-2016 Vaadin Ltd.
  3. *
  4. * Licensed under the Apache License, Version 2.0 (the "License"); you may not
  5. * use this file except in compliance with the License. You may obtain a copy of
  6. * the License at
  7. *
  8. * http://www.apache.org/licenses/LICENSE-2.0
  9. *
  10. * Unless required by applicable law or agreed to in writing, software
  11. * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  12. * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  13. * License for the specific language governing permissions and limitations under
  14. * the License.
  15. */
  16. package com.vaadin.v7.client.connectors;
  17. import java.util.ArrayList;
  18. import java.util.Arrays;
  19. import java.util.Collection;
  20. import java.util.HashMap;
  21. import java.util.HashSet;
  22. import java.util.Iterator;
  23. import java.util.List;
  24. import java.util.Map;
  25. import java.util.Map.Entry;
  26. import java.util.Set;
  27. import java.util.logging.Logger;
  28. import com.google.gwt.core.client.Scheduler;
  29. import com.google.gwt.core.client.Scheduler.ScheduledCommand;
  30. import com.google.gwt.dom.client.Element;
  31. import com.google.gwt.dom.client.EventTarget;
  32. import com.google.gwt.dom.client.NativeEvent;
  33. import com.google.gwt.event.shared.HandlerRegistration;
  34. import com.google.gwt.user.client.DOM;
  35. import com.google.gwt.user.client.Timer;
  36. import com.google.gwt.user.client.ui.Widget;
  37. import com.vaadin.client.ComponentConnector;
  38. import com.vaadin.client.ConnectorHierarchyChangeEvent;
  39. import com.vaadin.client.DeferredWorker;
  40. import com.vaadin.client.MouseEventDetailsBuilder;
  41. import com.vaadin.client.ServerConnector;
  42. import com.vaadin.client.TooltipInfo;
  43. import com.vaadin.client.WidgetUtil;
  44. import com.vaadin.client.communication.StateChangeEvent;
  45. import com.vaadin.client.communication.StateChangeEvent.StateChangeHandler;
  46. import com.vaadin.client.ui.AbstractComponentConnector;
  47. import com.vaadin.client.ui.AbstractHasComponentsConnector;
  48. import com.vaadin.client.ui.ConnectorFocusAndBlurHandler;
  49. import com.vaadin.client.ui.SimpleManagedLayout;
  50. import com.vaadin.shared.MouseEventDetails;
  51. import com.vaadin.shared.data.sort.SortDirection;
  52. import com.vaadin.shared.ui.Connect;
  53. import com.vaadin.v7.client.connectors.RpcDataSourceConnector.DetailsListener;
  54. import com.vaadin.v7.client.connectors.RpcDataSourceConnector.RpcDataSource;
  55. import com.vaadin.v7.client.widget.escalator.events.RowHeightChangedEvent;
  56. import com.vaadin.v7.client.widget.escalator.events.RowHeightChangedHandler;
  57. import com.vaadin.v7.client.widget.grid.CellReference;
  58. import com.vaadin.v7.client.widget.grid.CellStyleGenerator;
  59. import com.vaadin.v7.client.widget.grid.EditorHandler;
  60. import com.vaadin.v7.client.widget.grid.EventCellReference;
  61. import com.vaadin.v7.client.widget.grid.HeightAwareDetailsGenerator;
  62. import com.vaadin.v7.client.widget.grid.RowReference;
  63. import com.vaadin.v7.client.widget.grid.RowStyleGenerator;
  64. import com.vaadin.v7.client.widget.grid.events.BodyClickHandler;
  65. import com.vaadin.v7.client.widget.grid.events.BodyDoubleClickHandler;
  66. import com.vaadin.v7.client.widget.grid.events.ColumnReorderEvent;
  67. import com.vaadin.v7.client.widget.grid.events.ColumnReorderHandler;
  68. import com.vaadin.v7.client.widget.grid.events.ColumnResizeEvent;
  69. import com.vaadin.v7.client.widget.grid.events.ColumnResizeHandler;
  70. import com.vaadin.v7.client.widget.grid.events.ColumnVisibilityChangeEvent;
  71. import com.vaadin.v7.client.widget.grid.events.ColumnVisibilityChangeHandler;
  72. import com.vaadin.v7.client.widget.grid.events.GridClickEvent;
  73. import com.vaadin.v7.client.widget.grid.events.GridDoubleClickEvent;
  74. import com.vaadin.v7.client.widget.grid.sort.SortEvent;
  75. import com.vaadin.v7.client.widget.grid.sort.SortHandler;
  76. import com.vaadin.v7.client.widget.grid.sort.SortOrder;
  77. import com.vaadin.v7.client.widgets.Grid;
  78. import com.vaadin.v7.client.widgets.Grid.Column;
  79. import com.vaadin.v7.client.widgets.Grid.FooterCell;
  80. import com.vaadin.v7.client.widgets.Grid.FooterRow;
  81. import com.vaadin.v7.client.widgets.Grid.HeaderCell;
  82. import com.vaadin.v7.client.widgets.Grid.HeaderRow;
  83. import com.vaadin.v7.shared.ui.grid.EditorClientRpc;
  84. import com.vaadin.v7.shared.ui.grid.EditorServerRpc;
  85. import com.vaadin.v7.shared.ui.grid.GridClientRpc;
  86. import com.vaadin.v7.shared.ui.grid.GridColumnState;
  87. import com.vaadin.v7.shared.ui.grid.GridConstants;
  88. import com.vaadin.v7.shared.ui.grid.GridConstants.Section;
  89. import com.vaadin.v7.shared.ui.grid.GridServerRpc;
  90. import com.vaadin.v7.shared.ui.grid.GridState;
  91. import com.vaadin.v7.shared.ui.grid.GridStaticSectionState;
  92. import com.vaadin.v7.shared.ui.grid.GridStaticSectionState.CellState;
  93. import com.vaadin.v7.shared.ui.grid.GridStaticSectionState.RowState;
  94. import com.vaadin.v7.shared.ui.grid.ScrollDestination;
  95. import elemental.json.JsonObject;
  96. import elemental.json.JsonValue;
  97. /**
  98. * Connects the client side {@link Grid} widget with the server side
  99. * {@link com.vaadin.ui.components.grid.Grid} component.
  100. * <p>
  101. * The Grid is typed to JSONObject. The structure of the JSONObject is described
  102. * at {@link com.vaadin.shared.data.DataProviderRpc#setRowData(int, List)
  103. * DataProviderRpc.setRowData(int, List)}.
  104. *
  105. * @since 7.4
  106. * @author Vaadin Ltd
  107. */
  108. @Connect(com.vaadin.v7.ui.Grid.class)
  109. public class GridConnector extends AbstractHasComponentsConnector
  110. implements SimpleManagedLayout, DeferredWorker {
  111. private static final class CustomStyleGenerator implements
  112. CellStyleGenerator<JsonObject>, RowStyleGenerator<JsonObject> {
  113. @Override
  114. public String getStyle(CellReference<JsonObject> cellReference) {
  115. JsonObject row = cellReference.getRow();
  116. if (!row.hasKey(GridState.JSONKEY_CELLSTYLES)) {
  117. return null;
  118. }
  119. Column<?, JsonObject> column = cellReference.getColumn();
  120. if (!(column instanceof CustomGridColumn)) {
  121. // Selection checkbox column
  122. return null;
  123. }
  124. CustomGridColumn c = (CustomGridColumn) column;
  125. JsonObject cellStylesObject = row
  126. .getObject(GridState.JSONKEY_CELLSTYLES);
  127. assert cellStylesObject != null;
  128. if (cellStylesObject.hasKey(c.id)) {
  129. return cellStylesObject.getString(c.id);
  130. } else {
  131. return null;
  132. }
  133. }
  134. @Override
  135. public String getStyle(RowReference<JsonObject> rowReference) {
  136. JsonObject row = rowReference.getRow();
  137. if (row.hasKey(GridState.JSONKEY_ROWSTYLE)) {
  138. return row.getString(GridState.JSONKEY_ROWSTYLE);
  139. } else {
  140. return null;
  141. }
  142. }
  143. }
  144. /**
  145. * Custom implementation of the custom grid column using a JSONObject to
  146. * represent the cell value and String as a column type.
  147. */
  148. private class CustomGridColumn extends Grid.Column<Object, JsonObject> {
  149. private final String id;
  150. private AbstractGridRendererConnector<Object> rendererConnector;
  151. private AbstractComponentConnector editorConnector;
  152. private HandlerRegistration errorStateHandler;
  153. public CustomGridColumn(String id,
  154. AbstractGridRendererConnector<Object> rendererConnector) {
  155. super(rendererConnector.getRenderer());
  156. this.rendererConnector = rendererConnector;
  157. this.id = id;
  158. }
  159. /**
  160. * Sets a new renderer for this column object
  161. *
  162. * @param rendererConnector
  163. * a renderer connector object
  164. */
  165. public void setRenderer(
  166. AbstractGridRendererConnector<Object> rendererConnector) {
  167. setRenderer(rendererConnector.getRenderer());
  168. this.rendererConnector = rendererConnector;
  169. }
  170. @Override
  171. public Object getValue(final JsonObject obj) {
  172. final JsonObject rowData = obj.getObject(GridState.JSONKEY_DATA);
  173. if (rowData.hasKey(id)) {
  174. final JsonValue columnValue = rowData.get(id);
  175. return rendererConnector.decode(columnValue);
  176. }
  177. return null;
  178. }
  179. private AbstractComponentConnector getEditorConnector() {
  180. return editorConnector;
  181. }
  182. private void setEditorConnector(
  183. final AbstractComponentConnector editorConnector) {
  184. this.editorConnector = editorConnector;
  185. if (errorStateHandler != null) {
  186. errorStateHandler.removeHandler();
  187. errorStateHandler = null;
  188. }
  189. // Avoid nesting too deep
  190. if (editorConnector == null) {
  191. return;
  192. }
  193. errorStateHandler = editorConnector.addStateChangeHandler(
  194. "errorMessage", new StateChangeHandler() {
  195. @Override
  196. public void onStateChanged(
  197. StateChangeEvent stateChangeEvent) {
  198. String error = editorConnector
  199. .getState().errorMessage;
  200. if (error == null) {
  201. columnToErrorMessage
  202. .remove(CustomGridColumn.this);
  203. } else {
  204. // The error message is formatted as HTML;
  205. // therefore, we use this hack to make the
  206. // string human-readable.
  207. Element e = DOM.createElement("div");
  208. e.setInnerHTML(editorConnector
  209. .getState().errorMessage);
  210. error = getHeaderCaption() + ": "
  211. + e.getInnerText();
  212. columnToErrorMessage.put(CustomGridColumn.this,
  213. error);
  214. }
  215. // Handle Editor RPC before updating error status
  216. Scheduler.get()
  217. .scheduleFinally(new ScheduledCommand() {
  218. @Override
  219. public void execute() {
  220. updateErrorColumns();
  221. }
  222. });
  223. }
  224. public void updateErrorColumns() {
  225. getWidget().getEditor().setEditorError(
  226. getColumnErrors(),
  227. columnToErrorMessage.keySet());
  228. }
  229. });
  230. }
  231. }
  232. /*
  233. * An editor handler using Vaadin RPC to manage the editor state.
  234. */
  235. private class CustomEditorHandler implements EditorHandler<JsonObject> {
  236. private EditorServerRpc rpc = getRpcProxy(EditorServerRpc.class);
  237. private EditorRequest<JsonObject> currentRequest = null;
  238. private boolean serverInitiated = false;
  239. public CustomEditorHandler() {
  240. registerRpc(EditorClientRpc.class, new EditorClientRpc() {
  241. @Override
  242. public void bind(final int rowIndex) {
  243. // call this deferred to avoid issues with editing on init
  244. Scheduler.get().scheduleDeferred(new ScheduledCommand() {
  245. @Override
  246. public void execute() {
  247. GridConnector.this.getWidget().editRow(rowIndex);
  248. }
  249. });
  250. }
  251. @Override
  252. public void cancel(int rowIndex) {
  253. serverInitiated = true;
  254. GridConnector.this.getWidget().cancelEditor();
  255. }
  256. @Override
  257. public void confirmBind(final boolean bindSucceeded) {
  258. endRequest(bindSucceeded, null, null);
  259. }
  260. @Override
  261. public void confirmSave(boolean saveSucceeded,
  262. String errorMessage, List<String> errorColumnsIds) {
  263. endRequest(saveSucceeded, errorMessage, errorColumnsIds);
  264. }
  265. });
  266. }
  267. @Override
  268. public void bind(EditorRequest<JsonObject> request) {
  269. startRequest(request);
  270. rpc.bind(request.getRowIndex());
  271. }
  272. @Override
  273. public void save(EditorRequest<JsonObject> request) {
  274. startRequest(request);
  275. rpc.save(request.getRowIndex());
  276. }
  277. @Override
  278. public void cancel(EditorRequest<JsonObject> request) {
  279. if (!handleServerInitiated(request)) {
  280. // No startRequest as we don't get (or need)
  281. // a confirmation from the server
  282. rpc.cancel(request.getRowIndex());
  283. }
  284. }
  285. @Override
  286. public Widget getWidget(Grid.Column<?, JsonObject> column) {
  287. assert column != null;
  288. if (column instanceof CustomGridColumn) {
  289. AbstractComponentConnector c = ((CustomGridColumn) column)
  290. .getEditorConnector();
  291. if (c == null) {
  292. return null;
  293. }
  294. return c.getWidget();
  295. } else {
  296. throw new IllegalStateException("Unexpected column type: "
  297. + column.getClass().getName());
  298. }
  299. }
  300. /**
  301. * Used to handle the case where the editor calls us because it was
  302. * invoked by the server via RPC and not by the client. In that case,
  303. * the request can be simply synchronously completed.
  304. *
  305. * @param request
  306. * the request object
  307. * @return true if the request was originally triggered by the server,
  308. * false otherwise
  309. */
  310. private boolean handleServerInitiated(EditorRequest<?> request) {
  311. assert request != null : "Cannot handle null request";
  312. assert currentRequest == null : "Earlier request not yet finished";
  313. if (serverInitiated) {
  314. serverInitiated = false;
  315. request.success();
  316. return true;
  317. } else {
  318. return false;
  319. }
  320. }
  321. private void startRequest(EditorRequest<JsonObject> request) {
  322. assert currentRequest == null : "Earlier request not yet finished";
  323. currentRequest = request;
  324. }
  325. private void endRequest(boolean succeeded, String errorMessage,
  326. List<String> errorColumnsIds) {
  327. assert currentRequest != null : "Current request was null";
  328. /*
  329. * Clear current request first to ensure the state is valid if
  330. * another request is made in the callback.
  331. */
  332. EditorRequest<JsonObject> request = currentRequest;
  333. currentRequest = null;
  334. if (succeeded) {
  335. request.success();
  336. } else {
  337. Collection<Column<?, JsonObject>> errorColumns;
  338. if (errorColumnsIds != null) {
  339. errorColumns = new ArrayList<>();
  340. for (String colId : errorColumnsIds) {
  341. errorColumns.add(columnIdToColumn.get(colId));
  342. }
  343. } else {
  344. errorColumns = null;
  345. }
  346. request.failure(errorMessage, errorColumns);
  347. }
  348. }
  349. }
  350. private class ItemClickHandler
  351. implements BodyClickHandler, BodyDoubleClickHandler {
  352. @Override
  353. public void onClick(GridClickEvent event) {
  354. if (hasEventListener(GridConstants.ITEM_CLICK_EVENT_ID)) {
  355. fireItemClick(event.getTargetCell(), event.getNativeEvent());
  356. }
  357. }
  358. @Override
  359. public void onDoubleClick(GridDoubleClickEvent event) {
  360. if (hasEventListener(GridConstants.ITEM_CLICK_EVENT_ID)) {
  361. fireItemClick(event.getTargetCell(), event.getNativeEvent());
  362. }
  363. }
  364. private void fireItemClick(CellReference<?> cell,
  365. NativeEvent mouseEvent) {
  366. String rowKey = getRowKey((JsonObject) cell.getRow());
  367. String columnId = getColumnId(cell.getColumn());
  368. getRpcProxy(GridServerRpc.class).itemClick(rowKey, columnId,
  369. MouseEventDetailsBuilder
  370. .buildMouseEventDetails(mouseEvent));
  371. }
  372. }
  373. private ColumnReorderHandler<JsonObject> columnReorderHandler = new ColumnReorderHandler<JsonObject>() {
  374. @Override
  375. public void onColumnReorder(ColumnReorderEvent<JsonObject> event) {
  376. if (!columnsUpdatedFromState) {
  377. List<Column<?, JsonObject>> columns = getWidget().getColumns();
  378. final List<String> newColumnOrder = new ArrayList<>();
  379. for (Column<?, JsonObject> column : columns) {
  380. if (column instanceof CustomGridColumn) {
  381. newColumnOrder.add(((CustomGridColumn) column).id);
  382. } // the other case would be the multi selection column
  383. }
  384. getRpcProxy(GridServerRpc.class)
  385. .columnsReordered(newColumnOrder, columnOrder);
  386. columnOrder = newColumnOrder;
  387. getState().columnOrder = newColumnOrder;
  388. }
  389. }
  390. };
  391. private ColumnVisibilityChangeHandler<JsonObject> columnVisibilityChangeHandler = new ColumnVisibilityChangeHandler<JsonObject>() {
  392. @Override
  393. public void onVisibilityChange(
  394. ColumnVisibilityChangeEvent<JsonObject> event) {
  395. if (!columnsUpdatedFromState) {
  396. Column<?, JsonObject> column = event.getColumn();
  397. if (column instanceof CustomGridColumn) {
  398. getRpcProxy(GridServerRpc.class).columnVisibilityChanged(
  399. ((CustomGridColumn) column).id, column.isHidden(),
  400. event.isUserOriginated());
  401. for (GridColumnState state : getState().columns) {
  402. if (state.id.equals(((CustomGridColumn) column).id)) {
  403. state.hidden = event.isHidden();
  404. break;
  405. }
  406. }
  407. } else {
  408. getLogger().warning(
  409. "Visibility changed for a unknown column type in Grid: "
  410. + column.toString() + ", type "
  411. + column.getClass());
  412. }
  413. }
  414. }
  415. };
  416. private ColumnResizeHandler<JsonObject> columnResizeHandler = new ColumnResizeHandler<JsonObject>() {
  417. @Override
  418. public void onColumnResize(ColumnResizeEvent<JsonObject> event) {
  419. if (!columnsUpdatedFromState) {
  420. Column<?, JsonObject> column = event.getColumn();
  421. if (column instanceof CustomGridColumn) {
  422. getRpcProxy(GridServerRpc.class).columnResized(
  423. ((CustomGridColumn) column).id,
  424. column.getWidthActual());
  425. }
  426. }
  427. }
  428. };
  429. private class CustomDetailsGenerator
  430. implements HeightAwareDetailsGenerator {
  431. private final Map<String, ComponentConnector> idToDetailsMap = new HashMap<>();
  432. private final Map<String, Integer> idToRowIndex = new HashMap<>();
  433. @Override
  434. public Widget getDetails(int rowIndex) {
  435. String id = getId(rowIndex);
  436. if (id == null) {
  437. return null;
  438. }
  439. ComponentConnector componentConnector = idToDetailsMap.get(id);
  440. idToRowIndex.put(id, rowIndex);
  441. return componentConnector.getWidget();
  442. }
  443. @Override
  444. public double getDetailsHeight(int rowIndex) {
  445. // Case of null is handled in the getDetails method and this method
  446. // will not called if it returns null.
  447. String id = getId(rowIndex);
  448. ComponentConnector componentConnector = idToDetailsMap.get(id);
  449. getLayoutManager().setNeedsMeasureRecursively(componentConnector);
  450. getLayoutManager().layoutNow();
  451. return getLayoutManager().getOuterHeightDouble(
  452. componentConnector.getWidget().getElement());
  453. }
  454. /**
  455. * Fetches id from the row object that corresponds with the given
  456. * rowIndex.
  457. *
  458. * @since 7.6.1
  459. * @param rowIndex
  460. * the index of the row for which to fetch the id
  461. * @return id of the row if such id exists, {@code null} otherwise
  462. */
  463. private String getId(int rowIndex) {
  464. JsonObject row = getWidget().getDataSource().getRow(rowIndex);
  465. if (!row.hasKey(GridState.JSONKEY_DETAILS_VISIBLE) || row
  466. .getString(GridState.JSONKEY_DETAILS_VISIBLE).isEmpty()) {
  467. return null;
  468. }
  469. return row.getString(GridState.JSONKEY_DETAILS_VISIBLE);
  470. }
  471. public void updateConnectorHierarchy(List<ServerConnector> children) {
  472. Set<String> connectorIds = new HashSet<>();
  473. for (ServerConnector child : children) {
  474. if (child instanceof ComponentConnector) {
  475. connectorIds.add(child.getConnectorId());
  476. idToDetailsMap.put(child.getConnectorId(),
  477. (ComponentConnector) child);
  478. }
  479. }
  480. Set<String> removedDetails = new HashSet<>();
  481. for (Entry<String, ComponentConnector> entry : idToDetailsMap
  482. .entrySet()) {
  483. ComponentConnector connector = entry.getValue();
  484. String id = connector.getConnectorId();
  485. if (!connectorIds.contains(id)) {
  486. removedDetails.add(entry.getKey());
  487. if (idToRowIndex.containsKey(id)) {
  488. getWidget().setDetailsVisible(idToRowIndex.get(id),
  489. false);
  490. }
  491. }
  492. }
  493. for (String id : removedDetails) {
  494. idToDetailsMap.remove(id);
  495. idToRowIndex.remove(id);
  496. }
  497. }
  498. }
  499. /**
  500. * Class for handling scrolling issues with open details.
  501. *
  502. * @since 7.5.2
  503. */
  504. private class LazyDetailsScroller implements DeferredWorker {
  505. /* Timer value tested to work in our test cluster with slow IE8s. */
  506. private static final int DISABLE_LAZY_SCROLL_TIMEOUT = 1500;
  507. /*
  508. * Cancels details opening scroll after timeout. Avoids any unexpected
  509. * scrolls via details opening.
  510. */
  511. private Timer disableScroller = new Timer() {
  512. @Override
  513. public void run() {
  514. targetRow = -1;
  515. }
  516. };
  517. private Integer targetRow = -1;
  518. private ScrollDestination destination = null;
  519. public void scrollToRow(Integer row, ScrollDestination dest) {
  520. targetRow = row;
  521. destination = dest;
  522. disableScroller.schedule(DISABLE_LAZY_SCROLL_TIMEOUT);
  523. }
  524. /**
  525. * Inform LazyDetailsScroller that a details row has opened on a row.
  526. *
  527. * @param rowIndex
  528. * index of row with details now open
  529. */
  530. public void detailsOpened(int rowIndex) {
  531. if (targetRow == rowIndex) {
  532. getWidget().scrollToRow(targetRow, destination);
  533. disableScroller.run();
  534. }
  535. }
  536. @Override
  537. public boolean isWorkPending() {
  538. return disableScroller.isRunning();
  539. }
  540. }
  541. /**
  542. * Maps a generated column id to a grid column instance
  543. */
  544. private Map<String, CustomGridColumn> columnIdToColumn = new HashMap<>();
  545. private List<String> columnOrder = new ArrayList<>();
  546. /**
  547. * {@link #columnsUpdatedFromState} is set to true when
  548. * {@link #updateColumnOrderFromState(List)} is updating the column order
  549. * for the widget. This flag tells the {@link #columnReorderHandler} to not
  550. * send same data straight back to server. After updates, listener sets the
  551. * value back to false.
  552. */
  553. private boolean columnsUpdatedFromState;
  554. private RpcDataSource dataSource;
  555. /* Used to track Grid editor columns with validation errors */
  556. private final Map<Column<?, JsonObject>, String> columnToErrorMessage = new HashMap<>();
  557. private ItemClickHandler itemClickHandler = new ItemClickHandler();
  558. private String lastKnownTheme = null;
  559. private final CustomDetailsGenerator customDetailsGenerator = new CustomDetailsGenerator();
  560. private final CustomStyleGenerator styleGenerator = new CustomStyleGenerator();
  561. private final DetailsListener detailsListener = new DetailsListener() {
  562. @Override
  563. public void reapplyDetailsVisibility(final int rowIndex,
  564. final JsonObject row) {
  565. if (hasDetailsOpen(row)) {
  566. // Command for opening details row.
  567. ScheduledCommand openDetails = new ScheduledCommand() {
  568. @Override
  569. public void execute() {
  570. // Re-apply to force redraw.
  571. getWidget().setDetailsVisible(rowIndex, false);
  572. getWidget().setDetailsVisible(rowIndex, true);
  573. lazyDetailsScroller.detailsOpened(rowIndex);
  574. }
  575. };
  576. if (initialChange) {
  577. Scheduler.get().scheduleDeferred(openDetails);
  578. } else {
  579. Scheduler.get().scheduleFinally(openDetails);
  580. }
  581. } else {
  582. getWidget().setDetailsVisible(rowIndex, false);
  583. }
  584. }
  585. private boolean hasDetailsOpen(JsonObject row) {
  586. return row.hasKey(GridState.JSONKEY_DETAILS_VISIBLE)
  587. && row.getString(GridState.JSONKEY_DETAILS_VISIBLE) != null;
  588. }
  589. };
  590. private final LazyDetailsScroller lazyDetailsScroller = new LazyDetailsScroller();
  591. private final CustomEditorHandler editorHandler = new CustomEditorHandler();
  592. /*
  593. * Initially details need to behave a bit differently to allow some
  594. * escalator magic.
  595. */
  596. private boolean initialChange;
  597. @Override
  598. @SuppressWarnings("unchecked")
  599. public Grid<JsonObject> getWidget() {
  600. return (Grid<JsonObject>) super.getWidget();
  601. }
  602. @Override
  603. public GridState getState() {
  604. return (GridState) super.getState();
  605. }
  606. @Override
  607. protected void init() {
  608. super.init();
  609. // All scroll RPC calls are executed finally to avoid issues on init
  610. registerRpc(GridClientRpc.class, new GridClientRpc() {
  611. @Override
  612. public void scrollToStart() {
  613. /*
  614. * no need for lazyDetailsScrollAdjuster, because the start is
  615. * always 0, won't change a bit.
  616. */
  617. Scheduler.get().scheduleFinally(new ScheduledCommand() {
  618. @Override
  619. public void execute() {
  620. getWidget().scrollToStart();
  621. }
  622. });
  623. }
  624. @Override
  625. public void scrollToEnd() {
  626. Scheduler.get().scheduleFinally(new ScheduledCommand() {
  627. @Override
  628. public void execute() {
  629. getWidget().scrollToEnd();
  630. // Scrolls further if details opens.
  631. lazyDetailsScroller.scrollToRow(dataSource.size() - 1,
  632. ScrollDestination.END);
  633. }
  634. });
  635. }
  636. @Override
  637. public void scrollToRow(final int row,
  638. final ScrollDestination destination) {
  639. Scheduler.get().scheduleFinally(new ScheduledCommand() {
  640. @Override
  641. public void execute() {
  642. getWidget().scrollToRow(row, destination);
  643. // Scrolls a bit further if details opens.
  644. lazyDetailsScroller.scrollToRow(row, destination);
  645. }
  646. });
  647. }
  648. @Override
  649. public void recalculateColumnWidths() {
  650. getWidget().recalculateColumnWidths();
  651. }
  652. });
  653. /* Item click events */
  654. getWidget().addBodyClickHandler(itemClickHandler);
  655. getWidget().addBodyDoubleClickHandler(itemClickHandler);
  656. /* Style Generators */
  657. getWidget().setCellStyleGenerator(styleGenerator);
  658. getWidget().setRowStyleGenerator(styleGenerator);
  659. getWidget().addSortHandler(new SortHandler<JsonObject>() {
  660. @Override
  661. public void sort(SortEvent<JsonObject> event) {
  662. List<SortOrder> order = event.getOrder();
  663. String[] columnIds = new String[order.size()];
  664. SortDirection[] directions = new SortDirection[order.size()];
  665. for (int i = 0; i < order.size(); i++) {
  666. SortOrder sortOrder = order.get(i);
  667. CustomGridColumn column = (CustomGridColumn) sortOrder
  668. .getColumn();
  669. columnIds[i] = column.id;
  670. directions[i] = sortOrder.getDirection();
  671. }
  672. if (!Arrays.equals(columnIds, getState().sortColumns)
  673. || !Arrays.equals(directions, getState().sortDirs)) {
  674. // Report back to server if changed
  675. getRpcProxy(GridServerRpc.class).sort(columnIds, directions,
  676. event.isUserOriginated());
  677. }
  678. }
  679. });
  680. getWidget().setEditorHandler(editorHandler);
  681. getWidget().addColumnReorderHandler(columnReorderHandler);
  682. getWidget().addColumnVisibilityChangeHandler(
  683. columnVisibilityChangeHandler);
  684. getWidget().addColumnResizeHandler(columnResizeHandler);
  685. ConnectorFocusAndBlurHandler.addHandlers(this);
  686. getWidget().setDetailsGenerator(customDetailsGenerator);
  687. getLayoutManager().registerDependency(this, getWidget().getElement());
  688. // Handling row height changes
  689. getWidget().addRowHeightChangedHandler(new RowHeightChangedHandler() {
  690. @Override
  691. public void onRowHeightChanged(RowHeightChangedEvent event) {
  692. getLayoutManager()
  693. .setNeedsMeasureRecursively(GridConnector.this);
  694. getLayoutManager().layoutNow();
  695. }
  696. });
  697. layout();
  698. }
  699. @Override
  700. public void onStateChanged(final StateChangeEvent stateChangeEvent) {
  701. super.onStateChanged(stateChangeEvent);
  702. initialChange = stateChangeEvent.isInitialStateChange();
  703. // Column updates
  704. if (stateChangeEvent.hasPropertyChanged("columns")) {
  705. // Remove old columns
  706. purgeRemovedColumns();
  707. // Add new columns
  708. for (GridColumnState state : getState().columns) {
  709. if (!columnIdToColumn.containsKey(state.id)) {
  710. addColumnFromStateChangeEvent(state);
  711. }
  712. updateColumnFromStateChangeEvent(state);
  713. }
  714. }
  715. if (stateChangeEvent.hasPropertyChanged("columnOrder")) {
  716. if (orderNeedsUpdate(getState().columnOrder)) {
  717. updateColumnOrderFromState(getState().columnOrder);
  718. }
  719. }
  720. // Column resize mode
  721. if (stateChangeEvent.hasPropertyChanged("columnResizeMode")) {
  722. getWidget().setColumnResizeMode(getState().columnResizeMode);
  723. }
  724. // Header and footer
  725. if (stateChangeEvent.hasPropertyChanged("header")) {
  726. updateHeaderFromState(getState().header);
  727. }
  728. if (stateChangeEvent.hasPropertyChanged("footer")) {
  729. updateFooterFromState(getState().footer);
  730. }
  731. // Sorting
  732. if (stateChangeEvent.hasPropertyChanged("sortColumns")
  733. || stateChangeEvent.hasPropertyChanged("sortDirs")) {
  734. onSortStateChange();
  735. }
  736. // Editor
  737. if (stateChangeEvent.hasPropertyChanged("editorEnabled")) {
  738. getWidget().setEditorEnabled(getState().editorEnabled);
  739. }
  740. // Frozen columns
  741. if (stateChangeEvent.hasPropertyChanged("frozenColumnCount")) {
  742. getWidget().setFrozenColumnCount(getState().frozenColumnCount);
  743. }
  744. // Theme features
  745. String activeTheme = getConnection().getUIConnector().getActiveTheme();
  746. if (lastKnownTheme == null) {
  747. lastKnownTheme = activeTheme;
  748. } else if (!lastKnownTheme.equals(activeTheme)) {
  749. getWidget().resetSizesFromDom();
  750. lastKnownTheme = activeTheme;
  751. }
  752. }
  753. private void updateColumnOrderFromState(List<String> stateColumnOrder) {
  754. CustomGridColumn[] columns = new CustomGridColumn[stateColumnOrder
  755. .size()];
  756. int i = 0;
  757. for (String id : stateColumnOrder) {
  758. columns[i] = columnIdToColumn.get(id);
  759. i++;
  760. }
  761. columnsUpdatedFromState = true;
  762. getWidget().setColumnOrder(columns);
  763. columnsUpdatedFromState = false;
  764. columnOrder = stateColumnOrder;
  765. }
  766. private boolean orderNeedsUpdate(List<String> stateColumnOrder) {
  767. if (stateColumnOrder.size() == columnOrder.size()) {
  768. for (int i = 0; i < columnOrder.size(); ++i) {
  769. if (!stateColumnOrder.get(i).equals(columnOrder.get(i))) {
  770. return true;
  771. }
  772. }
  773. return false;
  774. }
  775. return true;
  776. }
  777. private void updateHeaderFromState(GridStaticSectionState state) {
  778. getWidget().setHeaderVisible(state.visible);
  779. while (getWidget().getHeaderRowCount() > 0) {
  780. getWidget().removeHeaderRow(0);
  781. }
  782. for (RowState rowState : state.rows) {
  783. HeaderRow row = getWidget().appendHeaderRow();
  784. if (rowState.defaultRow) {
  785. getWidget().setDefaultHeaderRow(row);
  786. }
  787. for (CellState cellState : rowState.cells) {
  788. CustomGridColumn column = columnIdToColumn
  789. .get(cellState.columnId);
  790. updateHeaderCellFromState(row.getCell(column), cellState);
  791. }
  792. for (Set<String> group : rowState.cellGroups.keySet()) {
  793. Grid.Column<?, ?>[] columns = new Grid.Column<?, ?>[group
  794. .size()];
  795. CellState cellState = rowState.cellGroups.get(group);
  796. int i = 0;
  797. for (String columnId : group) {
  798. columns[i] = columnIdToColumn.get(columnId);
  799. i++;
  800. }
  801. // Set state to be the same as first in group.
  802. updateHeaderCellFromState(row.join(columns), cellState);
  803. }
  804. row.setStyleName(rowState.styleName);
  805. }
  806. }
  807. private void updateHeaderCellFromState(HeaderCell cell,
  808. CellState cellState) {
  809. switch (cellState.type) {
  810. case TEXT:
  811. cell.setText(cellState.text);
  812. break;
  813. case HTML:
  814. cell.setHtml(cellState.html);
  815. break;
  816. case WIDGET:
  817. ComponentConnector connector = (ComponentConnector) cellState.connector;
  818. if (connector != null) {
  819. cell.setWidget(connector.getWidget());
  820. } else {
  821. // This happens if you do setVisible(false) on the component on
  822. // the server side
  823. cell.setWidget(null);
  824. }
  825. break;
  826. default:
  827. throw new IllegalStateException(
  828. "unexpected cell type: " + cellState.type);
  829. }
  830. cell.setStyleName(cellState.styleName);
  831. }
  832. private void updateFooterFromState(GridStaticSectionState state) {
  833. getWidget().setFooterVisible(state.visible);
  834. while (getWidget().getFooterRowCount() > 0) {
  835. getWidget().removeFooterRow(0);
  836. }
  837. for (RowState rowState : state.rows) {
  838. FooterRow row = getWidget().appendFooterRow();
  839. for (CellState cellState : rowState.cells) {
  840. CustomGridColumn column = columnIdToColumn
  841. .get(cellState.columnId);
  842. updateFooterCellFromState(row.getCell(column), cellState);
  843. }
  844. for (Set<String> group : rowState.cellGroups.keySet()) {
  845. Grid.Column<?, ?>[] columns = new Grid.Column<?, ?>[group
  846. .size()];
  847. CellState cellState = rowState.cellGroups.get(group);
  848. int i = 0;
  849. for (String columnId : group) {
  850. columns[i] = columnIdToColumn.get(columnId);
  851. i++;
  852. }
  853. // Set state to be the same as first in group.
  854. updateFooterCellFromState(row.join(columns), cellState);
  855. }
  856. row.setStyleName(rowState.styleName);
  857. }
  858. }
  859. private void updateFooterCellFromState(FooterCell cell,
  860. CellState cellState) {
  861. switch (cellState.type) {
  862. case TEXT:
  863. cell.setText(cellState.text);
  864. break;
  865. case HTML:
  866. cell.setHtml(cellState.html);
  867. break;
  868. case WIDGET:
  869. ComponentConnector connector = (ComponentConnector) cellState.connector;
  870. if (connector != null) {
  871. cell.setWidget(connector.getWidget());
  872. } else {
  873. // This happens if you do setVisible(false) on the component on
  874. // the server side
  875. cell.setWidget(null);
  876. }
  877. break;
  878. default:
  879. throw new IllegalStateException(
  880. "unexpected cell type: " + cellState.type);
  881. }
  882. cell.setStyleName(cellState.styleName);
  883. }
  884. /**
  885. * Updates a column from a state change event.
  886. *
  887. * @param columnIndex
  888. * The index of the column to update
  889. */
  890. private void updateColumnFromStateChangeEvent(GridColumnState columnState) {
  891. CustomGridColumn column = columnIdToColumn.get(columnState.id);
  892. columnsUpdatedFromState = true;
  893. updateColumnFromState(column, columnState);
  894. columnsUpdatedFromState = false;
  895. }
  896. /**
  897. * Adds a new column to the grid widget from a state change event
  898. *
  899. * @param columnIndex
  900. * The index of the column, according to how it
  901. */
  902. private void addColumnFromStateChangeEvent(GridColumnState state) {
  903. @SuppressWarnings("unchecked")
  904. CustomGridColumn column = new CustomGridColumn(state.id,
  905. ((AbstractGridRendererConnector<Object>) state.rendererConnector));
  906. columnIdToColumn.put(state.id, column);
  907. /*
  908. * Add column to grid. Reordering is handled as a separate problem.
  909. */
  910. getWidget().addColumn(column);
  911. columnOrder.add(state.id);
  912. }
  913. /**
  914. * Updates the column values from a state
  915. *
  916. * @param column
  917. * The column to update
  918. * @param state
  919. * The state to get the data from
  920. */
  921. @SuppressWarnings("unchecked")
  922. private static void updateColumnFromState(CustomGridColumn column,
  923. GridColumnState state) {
  924. column.setWidth(state.width);
  925. column.setMinimumWidth(state.minWidth);
  926. column.setMaximumWidth(state.maxWidth);
  927. column.setExpandRatio(state.expandRatio);
  928. assert state.rendererConnector instanceof AbstractGridRendererConnector : "GridColumnState.rendererConnector is invalid (not subclass of AbstractGridRendererConnector)";
  929. column.setRenderer(
  930. (AbstractGridRendererConnector<Object>) state.rendererConnector);
  931. column.setSortable(state.sortable);
  932. column.setResizable(state.resizable);
  933. column.setHeaderCaption(state.headerCaption);
  934. column.setHidden(state.hidden);
  935. column.setHidable(state.hidable);
  936. column.setHidingToggleCaption(state.hidingToggleCaption);
  937. column.setEditable(state.editable);
  938. column.setEditorConnector(
  939. (AbstractComponentConnector) state.editorConnector);
  940. }
  941. /**
  942. * Removes any orphan columns that has been removed from the state from the
  943. * grid
  944. */
  945. private void purgeRemovedColumns() {
  946. // Get columns still registered in the state
  947. Set<String> columnsInState = new HashSet<>();
  948. for (GridColumnState columnState : getState().columns) {
  949. columnsInState.add(columnState.id);
  950. }
  951. // Remove column no longer in state
  952. Iterator<String> columnIdIterator = columnIdToColumn.keySet()
  953. .iterator();
  954. while (columnIdIterator.hasNext()) {
  955. String id = columnIdIterator.next();
  956. if (!columnsInState.contains(id)) {
  957. CustomGridColumn column = columnIdToColumn.get(id);
  958. columnIdIterator.remove();
  959. getWidget().removeColumn(column);
  960. columnOrder.remove(id);
  961. }
  962. }
  963. }
  964. public void setDataSource(RpcDataSource dataSource) {
  965. this.dataSource = dataSource;
  966. getWidget().setDataSource(this.dataSource);
  967. }
  968. private void onSortStateChange() {
  969. List<SortOrder> sortOrder = new ArrayList<>();
  970. String[] sortColumns = getState().sortColumns;
  971. SortDirection[] sortDirs = getState().sortDirs;
  972. for (int i = 0; i < sortColumns.length; i++) {
  973. sortOrder.add(new SortOrder(columnIdToColumn.get(sortColumns[i]),
  974. sortDirs[i]));
  975. }
  976. getWidget().setSortOrder(sortOrder);
  977. }
  978. private Logger getLogger() {
  979. return Logger.getLogger(getClass().getName());
  980. }
  981. /**
  982. * Gets the row key for a row object.
  983. *
  984. * @param row
  985. * the row object
  986. * @return the key for the given row
  987. */
  988. public String getRowKey(JsonObject row) {
  989. final Object key = dataSource.getRowKey(row);
  990. assert key instanceof String : "Internal key was not a String but a "
  991. + key.getClass().getSimpleName() + " (" + key + ")";
  992. return (String) key;
  993. }
  994. /*
  995. * (non-Javadoc)
  996. *
  997. * @see
  998. * com.vaadin.client.HasComponentsConnector#updateCaption(com.vaadin.client
  999. * .ComponentConnector)
  1000. */
  1001. @Override
  1002. public void updateCaption(ComponentConnector connector) {
  1003. // TODO Auto-generated method stub
  1004. }
  1005. @Override
  1006. public void onConnectorHierarchyChange(
  1007. ConnectorHierarchyChangeEvent connectorHierarchyChangeEvent) {
  1008. customDetailsGenerator.updateConnectorHierarchy(getChildren());
  1009. }
  1010. public String getColumnId(Grid.Column<?, ?> column) {
  1011. if (column instanceof CustomGridColumn) {
  1012. return ((CustomGridColumn) column).id;
  1013. }
  1014. return null;
  1015. }
  1016. @Override
  1017. public void layout() {
  1018. getWidget().onResize();
  1019. }
  1020. @Override
  1021. public boolean isWorkPending() {
  1022. return lazyDetailsScroller.isWorkPending();
  1023. }
  1024. /**
  1025. * Gets the listener used by this connector for tracking when row detail
  1026. * visibility changes.
  1027. *
  1028. * @since 7.5.0
  1029. * @return the used details listener
  1030. */
  1031. public DetailsListener getDetailsListener() {
  1032. return detailsListener;
  1033. }
  1034. @Override
  1035. public boolean hasTooltip() {
  1036. return getState().hasDescriptions || super.hasTooltip();
  1037. }
  1038. @Override
  1039. public TooltipInfo getTooltipInfo(Element element) {
  1040. CellReference<JsonObject> cell = getWidget().getCellReference(element);
  1041. if (cell != null) {
  1042. JsonObject row = cell.getRow();
  1043. if (row == null) {
  1044. return null;
  1045. }
  1046. Column<?, JsonObject> column = cell.getColumn();
  1047. if (!(column instanceof CustomGridColumn)) {
  1048. // Selection checkbox column
  1049. return null;
  1050. }
  1051. CustomGridColumn c = (CustomGridColumn) column;
  1052. JsonObject cellDescriptions = row
  1053. .getObject(GridState.JSONKEY_CELLDESCRIPTION);
  1054. if (cellDescriptions != null && cellDescriptions.hasKey(c.id)) {
  1055. return new TooltipInfo(cellDescriptions.getString(c.id));
  1056. } else if (row.hasKey(GridState.JSONKEY_ROWDESCRIPTION)) {
  1057. return new TooltipInfo(
  1058. row.getString(GridState.JSONKEY_ROWDESCRIPTION));
  1059. } else {
  1060. return null;
  1061. }
  1062. }
  1063. return super.getTooltipInfo(element);
  1064. }
  1065. @Override
  1066. protected void sendContextClickEvent(MouseEventDetails details,
  1067. EventTarget eventTarget) {
  1068. // if element is the resize indicator, ignore the event
  1069. if (isResizeHandle(eventTarget)) {
  1070. WidgetUtil.clearTextSelection();
  1071. return;
  1072. }
  1073. EventCellReference<JsonObject> eventCell = getWidget().getEventCell();
  1074. Section section = eventCell.getSection();
  1075. String rowKey = null;
  1076. if (eventCell.isBody() && eventCell.getRow() != null) {
  1077. rowKey = getRowKey(eventCell.getRow());
  1078. }
  1079. String columnId = getColumnId(eventCell.getColumn());
  1080. getRpcProxy(GridServerRpc.class).contextClick(eventCell.getRowIndex(),
  1081. rowKey, columnId, section, details);
  1082. WidgetUtil.clearTextSelection();
  1083. }
  1084. private boolean isResizeHandle(EventTarget eventTarget) {
  1085. if (Element.is(eventTarget)) {
  1086. Element e = Element.as(eventTarget);
  1087. if (e.getClassName().contains("-column-resize-handle")) {
  1088. return true;
  1089. }
  1090. }
  1091. return false;
  1092. }
  1093. /**
  1094. * Creates a concatenation of all columns errors for Editor.
  1095. *
  1096. * @since 7.6
  1097. * @return displayed error string
  1098. */
  1099. private String getColumnErrors() {
  1100. List<String> errors = new ArrayList<>();
  1101. for (Grid.Column<?, JsonObject> c : getWidget().getColumns()) {
  1102. if (!(c instanceof CustomGridColumn)) {
  1103. continue;
  1104. }
  1105. String error = columnToErrorMessage.get(c);
  1106. if (error != null) {
  1107. errors.add(error);
  1108. }
  1109. }
  1110. String result = "";
  1111. Iterator<String> i = errors.iterator();
  1112. while (i.hasNext()) {
  1113. result += i.next();
  1114. if (i.hasNext()) {
  1115. result += ", ";
  1116. }
  1117. }
  1118. return result.isEmpty() ? null : result;
  1119. }
  1120. }