| 1 |
/** SCHMITZM - This file is part of the java library of Martin O.J. Schmitz (SCHMITZM) |
/******************************************************************************* |
| 2 |
|
* Copyright (c) 2009 Martin O. J. Schmitz. |
| 3 |
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. |
* |
| 4 |
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. |
* This file is part of the SCHMITZM library - a collection of utility |
| 5 |
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA |
* classes based on Java 1.6, focusing (not only) on Java Swing |
| 6 |
|
* and the Geotools library. |
| 7 |
Diese Bibliothek ist freie Software; Sie dürfen sie unter den Bedingungen der GNU Lesser General Public License, wie von der Free Software Foundation veröffentlicht, weiterverteilen und/oder modifizieren; entweder gemäß Version 2.1 der Lizenz oder (nach Ihrer Option) jeder späteren Version. |
* |
| 8 |
Diese Bibliothek wird in der Hoffnung weiterverbreitet, daß sie nützlich sein wird, jedoch OHNE IRGENDEINE GARANTIE, auch ohne die implizierte Garantie der MARKTREIFE oder der VERWENDBARKEIT FÜR EINEN BESTIMMTEN ZWECK. Mehr Details finden Sie in der GNU Lesser General Public License. |
* The SCHMITZM project is hosted at: |
| 9 |
Sie sollten eine Kopie der GNU Lesser General Public License zusammen mit dieser Bibliothek erhalten haben; falls nicht, schreiben Sie an die Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA. |
* http://wald.intevation.org/projects/schmitzm/ |
| 10 |
**/ |
* |
| 11 |
package skrueger.geotools; |
* This program is free software; you can redistribute it and/or |
| 12 |
|
* modify it under the terms of the GNU Lesser General Public License |
| 13 |
import java.util.Iterator; |
* as published by the Free Software Foundation; either version 3 |
| 14 |
import java.util.Map; |
* of the License, or (at your option) any later version. |
| 15 |
import java.util.Vector; |
* |
| 16 |
|
* This program is distributed in the hope that it will be useful, |
| 17 |
import org.apache.log4j.Logger; |
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 18 |
import org.geotools.data.DefaultQuery; |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 19 |
import org.geotools.data.FeatureSource; |
* GNU General Public License for more details. |
| 20 |
import org.geotools.data.Query; |
* |
| 21 |
import org.geotools.data.memory.MemoryDataStore; |
* You should have received a copy of the GNU Lesser General Public License (license.txt) |
| 22 |
import org.geotools.feature.AttributeType; |
* along with this program; if not, write to the Free Software |
| 23 |
import org.geotools.feature.FeatureCollection; |
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. |
| 24 |
import org.opengis.filter.Filter; |
* or try this link: http://www.gnu.org/licenses/lgpl.html |
| 25 |
|
* |
| 26 |
import schmitzm.geotools.gui.FeatureCollectionTableModel; |
* Contributors: |
| 27 |
import skrueger.AttributeMetaData; |
* Martin O. J. Schmitz - initial API and implementation |
| 28 |
import skrueger.i8n.I8NUtil; |
* Stefan A. Krüger - additional utility classes |
| 29 |
import skrueger.i8n.Translation; |
******************************************************************************/ |
| 30 |
|
package skrueger.geotools; |
| 31 |
import com.vividsolutions.jts.geom.Envelope; |
|
| 32 |
|
import java.util.HashMap; |
| 33 |
/** |
import java.util.List; |
| 34 |
* This class extends the the {@link FeatureCollectionTableModel} with the |
import java.util.Vector; |
| 35 |
* functionalities of the {@link AttributeMetaData} of |
|
| 36 |
* {@linkplain StyledLayerInterface styled objects}. |
import org.apache.log4j.Logger; |
| 37 |
* <ul> |
import org.geotools.data.DefaultQuery; |
| 38 |
* <li>column names are translated according to |
import org.geotools.data.FeatureSource; |
| 39 |
* {@link AttributeMetaData#getTitle()}</li> |
import org.geotools.data.Query; |
| 40 |
* <li>columns are hidden according to {@link AttributeMetaData#isVisible()()}</li> |
import org.geotools.feature.FeatureCollection; |
| 41 |
* </ul> |
import org.opengis.feature.simple.SimpleFeature; |
| 42 |
* |
import org.opengis.feature.simple.SimpleFeatureType; |
| 43 |
* @author <a href="mailto:[email protected]">Martin Schmitz</a> |
import org.opengis.feature.type.AttributeDescriptor; |
| 44 |
* (University of Bonn/Germany) |
import org.opengis.filter.Filter; |
| 45 |
*/ |
|
| 46 |
public class StyledFeatureCollectionTableModel extends |
import schmitzm.geotools.feature.FeatureUtil; |
| 47 |
FeatureCollectionTableModel { |
import schmitzm.geotools.gui.FeatureCollectionTableModel; |
| 48 |
final static private Logger LOGGER = Logger |
import skrueger.AttributeMetadataInterface; |
| 49 |
.getLogger(StyledFeatureCollectionTableModel.class); |
import skrueger.AttributeMetadataImpl; |
| 50 |
/** Holds the data source as styled layer. */ |
|
| 51 |
protected StyledLayerInterface<?> layer = null; |
import com.vividsolutions.jts.geom.Envelope; |
| 52 |
/** Contains only the visible elements of the {@link AttributeMetaData}-Map */ |
|
| 53 |
protected Map<Integer, AttributeMetaData> visibleAMD = null; |
/** |
| 54 |
/** Holds the data source for the table as {@code FeatureSource}. */ |
* This class extends the the {@link FeatureCollectionTableModel} with the |
| 55 |
protected FeatureSource featureSource = null; |
* functionalities of the {@link AttributeMetadataImpl}. |
| 56 |
/** Contains the complete {@link AttributeMetaData}-Map of the styled layer. */ |
* <ul> |
| 57 |
protected Map<Integer, AttributeMetaData> origAMD = null; |
* <li>column names are translated according to |
| 58 |
/** Holds the current filter on the table */ |
* {@link AttributeMetadataImpl#getTitle()}</li> |
| 59 |
protected Filter filter = null; |
* <li>columns are hidden according to {@link AttributeMetaData#isVisible()()}</li> |
| 60 |
/** Holds the Bounds for all features. Only set once during the constructor **/ |
* <li>Any filter defined in the {@link StyledFeaturesInterface} will be |
| 61 |
protected Envelope bounds; |
* applied.</li> |
| 62 |
|
* </ul> |
| 63 |
|
* |
| 64 |
|
* @author Stefan A. Krüger |
| 65 |
/** |
*/ |
| 66 |
* Creates a new table model for a styled layer. |
public class StyledFeatureCollectionTableModel extends |
| 67 |
* |
FeatureCollectionTableModel { |
| 68 |
* @param layer |
final static private Logger LOGGER = Logger |
| 69 |
* the styled layer |
.getLogger(StyledFeatureCollectionTableModel.class); |
| 70 |
*/ |
/** Contains the complete {@link AttributeMetadataImpl}-Map of the styled layer. */ |
| 71 |
public StyledFeatureCollectionTableModel( |
protected AttributeMetadataMap<? extends AttributeMetadataInterface> amdMap = null; |
| 72 |
StyledFeatureCollectionInterface layer) { |
/** Holds the current filter on the table */ |
| 73 |
this(layer, Filter.INCLUDE); |
protected Filter filter = null; |
| 74 |
} |
/** Holds the Bounds for all features. Only set once during the constructor **/ |
| 75 |
|
protected Envelope bounds; |
| 76 |
/** |
/** |
| 77 |
* Creates a new table model for a styled layer. |
* Tooltips für die Spaltennamen. Wird nur beim Aufruf von |
| 78 |
* |
* {@link #reorganize} befuellt. |
| 79 |
* @param layer |
*/ |
| 80 |
* the styled layer |
protected String[] colTooltips = null; |
| 81 |
* @param filter |
|
| 82 |
* filter applied to the table |
/** A cache for the #sortedValuesVisibleOnly() **/ |
| 83 |
*/ |
protected List<? extends AttributeMetadataInterface> amdMapVisibleOnly = null; |
| 84 |
public StyledFeatureCollectionTableModel( |
|
| 85 |
StyledFeatureCollectionInterface layer, Filter filter) { |
/** |
| 86 |
super(); |
* Creates a new table model for a styled layer. |
| 87 |
setFeatureCollection(layer, filter); |
* |
| 88 |
} |
* @param styledFeatures |
| 89 |
|
* the styled layer |
| 90 |
|
* @param filter |
| 91 |
/** |
* filter applied to the table |
| 92 |
* Creates a new table model for a styled layer. |
*/ |
| 93 |
* |
public StyledFeatureCollectionTableModel( |
| 94 |
* @param layer |
StyledFeaturesInterface<?> styledFeatures) { |
| 95 |
* the styled layer |
setStyledFeatures(styledFeatures); |
| 96 |
*/ |
} |
| 97 |
public StyledFeatureCollectionTableModel(StyledFeaturesInterface layer) { |
|
| 98 |
this(layer, Filter.INCLUDE); |
/** |
| 99 |
} |
* This overwritten method filters the values for NODATA-values defined in |
| 100 |
|
* the {@link AttributeMetadataImpl} |
| 101 |
/** |
*/ |
| 102 |
* Creates a new table model for a styled layer. |
@Override |
| 103 |
* |
public Object getValueAt(int row, int col) { |
| 104 |
* @param layer |
Object rawValue = super.getValueAt(row, col); |
| 105 |
* the styled layer |
return amdMap.sortedValuesVisibleOnly().get(col).fiterNodata(rawValue); |
| 106 |
* @param filter |
} |
| 107 |
* filter applied to the table |
|
| 108 |
*/ |
/** |
| 109 |
public StyledFeatureCollectionTableModel(StyledFeaturesInterface layer, |
* Sets a new data source for the table. |
| 110 |
Filter filter) { |
* |
| 111 |
super(); |
* @param fs |
| 112 |
setFeatureCollection(layer, filter); |
* the feature source |
| 113 |
} |
* @param amdm |
| 114 |
|
* {@link AttributeMetadataImpl}-Map to define the visible attributes |
| 115 |
/** |
* and translation |
| 116 |
* Sets a new data source for the table. |
*/ |
| 117 |
* |
protected void setFeatureSource( |
| 118 |
* @param fs |
FeatureSource<SimpleFeatureType, SimpleFeature> fs, |
| 119 |
* the feature source |
AttributeMetadataMap<? extends AttributeMetadataInterface> amdm, Filter filter) throws Exception { |
| 120 |
* @param amd |
|
| 121 |
* {@link AttributeMetaData}-Map to define the visible attributes |
if (filter == null) |
| 122 |
* and translation |
filter = Filter.INCLUDE; |
| 123 |
*/ |
|
| 124 |
protected void setFeatureSource(FeatureSource fs, |
// this.featureSource = fs; |
| 125 |
Map<Integer, AttributeMetaData> amd, Filter filter) |
this.filter = filter; |
| 126 |
throws Exception { |
this.amdMap = amdm; |
| 127 |
if (filter == null) |
this.amdMapVisibleOnly = amdMap.sortedValuesVisibleOnly(); |
| 128 |
filter = Filter.INCLUDE; |
|
| 129 |
|
FeatureCollection<SimpleFeatureType, SimpleFeature> fc = null; |
| 130 |
this.featureSource = fs; |
if (fs != null) { |
| 131 |
this.filter = filter; |
|
| 132 |
this.origAMD = amd; |
bounds = fs.getBounds(); |
| 133 |
this.visibleAMD = null; |
|
| 134 |
|
final SimpleFeatureType schema = fs.getSchema(); |
| 135 |
FeatureCollection fc = null; |
Query query = new DefaultQuery(schema.getTypeName(), filter); |
| 136 |
if (fs != null) { |
if (amdm != null) { |
| 137 |
|
Vector<String> visibleAttrNames = new Vector<String>(); |
| 138 |
bounds = fs.getBounds(); |
|
| 139 |
|
// Add the column with the geometry (usually "the_geom") always |
| 140 |
Query query = new DefaultQuery(fs.getSchema().getTypeName(), filter); |
visibleAttrNames.add(schema.getGeometryDescriptor() |
| 141 |
if (amd != null) { |
.getLocalName()); |
| 142 |
// determine the names of the visible Attributes |
|
| 143 |
this.visibleAMD = StyledLayerUtil.getVisibleAttributeMetaData( |
// Add other visible attributes as ordered by weights |
| 144 |
amd, true); |
for (AttributeMetadataInterface a : amdMapVisibleOnly) { |
| 145 |
Vector<String> visibleAttrNames = new Vector<String>(); |
visibleAttrNames.add(a.getLocalName()); |
| 146 |
// Add the column with the geometry (usually "the_geom") |
} |
| 147 |
visibleAttrNames.add(fs.getSchema().getDefaultGeometry() |
|
| 148 |
.getLocalName()); |
// Tested with 2.6.x trunk from 2009-11-26 and it now works. So |
| 149 |
for (int attrIdx : visibleAMD.keySet()) { |
// we only request the properties we need! |
| 150 |
|
// /** |
| 151 |
/** |
// * I got NPEs when properties contained only [the_geom] |
| 152 |
* If the user removed columns from the schema of the DBF |
// ?!??!!?? |
| 153 |
* file, there might exist AttributeMetaData for columns |
// */ |
| 154 |
* that don't exists. We check here to avoid an |
// if (properties.length > 1) { |
| 155 |
* ArrayOutOfIndex. |
query = new DefaultQuery(schema.getTypeName(), filter, |
| 156 |
*/ |
visibleAttrNames.toArray(new String[] {})); |
| 157 |
if (attrIdx < fs.getSchema().getAttributeCount()) { |
// } else { |
| 158 |
final AttributeType attributeTypeAtIdx = fs.getSchema() |
// query = new DefaultQuery(schema.getTypeName(), filter); |
| 159 |
.getAttributeType(attrIdx); |
// } |
| 160 |
visibleAttrNames.add(attributeTypeAtIdx.getLocalName()); |
} |
| 161 |
} else { |
fc = fs.getFeatures(query); |
| 162 |
LOGGER.warn("AttributeMetaData has been found for columnIdx="+attrIdx+", but fs.getSchema().getAttributeCount() = "+fs.getSchema().getAttributeCount()+". Ignored."); |
} |
| 163 |
} |
setFeatureCollection(fc); |
| 164 |
} |
} |
| 165 |
|
|
| 166 |
// create a query for the visible attributes |
/** |
| 167 |
String[] properties = visibleAttrNames.toArray(new String[0]); |
* Converts the {@code StyledFeatureCollection} to a {@code FeatureSource} |
| 168 |
|
* and sets this as the new data source for the table. |
| 169 |
LOGGER.debug("Query contains the following attributes: " |
* |
| 170 |
+ visibleAttrNames); |
* @param fs |
| 171 |
|
* the feature source |
| 172 |
query = new DefaultQuery(fs.getSchema().getTypeName(), filter, |
* @param amd |
| 173 |
properties); |
* {@link AttributeMetadataImpl}-Map to define the visible attributes |
| 174 |
} |
* and translation |
| 175 |
fc = fs.getFeatures(query); |
*/ |
| 176 |
|
public void setStyledFeatures(StyledFeaturesInterface<?> styledFeatures) { |
| 177 |
// FAILS:!!!, even with query = new |
try { |
| 178 |
// DefaultQuery(fs.getSchema().getTypeName(), filter); |
if (styledFeatures == null) |
| 179 |
// java.lang.UnsupportedOperationException: Unknown feature |
setFeatureSource(null, null, null); |
| 180 |
// attribute: PQM_MOD |
else { |
| 181 |
// at |
setFeatureSource(styledFeatures.getFeatureSource(), |
| 182 |
// schmitzm.geotools.feature.FeatureOperationTree.evaluate(FeatureOperationTree.java:93) |
styledFeatures.getAttributeMetaDataMap(), |
| 183 |
// bounds = fc.getBounds(); |
styledFeatures.getFilter()); |
| 184 |
// SK, 17.4.2009 |
} |
| 185 |
// |
} catch (Exception err) { |
| 186 |
// System.out.println("Filter = "+filter); |
throw new RuntimeException(err); |
| 187 |
// System.out.println("Size of FC = "+fc.size()); |
} |
| 188 |
// System.out.println("anz att= "+fc.getNumberOfAttributes()); |
} |
| 189 |
} |
|
| 190 |
setFeatureCollection(fc); |
/** |
| 191 |
} |
* After calling {@code super.reorganize(.)} this method replaced the column |
| 192 |
|
* descriptions with the titles of the {@code AttributeMetaData}. |
| 193 |
/** |
* |
| 194 |
* Converts the {@code StyledFeatureCollection} to a {@code FeatureSource} |
* @param fireTableStructureChanged |
| 195 |
* and sets this as the new data source for the table. |
* indicates whether a table event is initiated after reorganize |
| 196 |
* |
*/ |
| 197 |
* @param fs |
@Override |
| 198 |
* the feature source |
protected void reorganize(boolean fireTableStructureChanged) { |
| 199 |
* @param amd |
|
| 200 |
* {@link AttributeMetaData}-Map to define the visible attributes |
featureArray = FeatureUtil.featuresToArray(featureTable); |
| 201 |
* and translation |
if (featureArray == null || featureArray.length == 0) { |
| 202 |
*/ |
colNames = new String[0]; |
| 203 |
public void setFeatureCollection(StyledFeaturesInterface layer, |
colTooltips = new String[0]; // Only set and used in |
| 204 |
Filter filter) { |
// StyledFeatureCollectionTableModel |
| 205 |
this.layer = layer; |
colClass = new Class[0]; |
| 206 |
try { |
} else { |
| 207 |
if (layer == null) |
// Struktur der Tabelle vom AttributeMetaDtaaMap übernehmen |
| 208 |
setFeatureSource(null, null, null); |
SimpleFeatureType schema = featureArray[0].getFeatureType(); |
| 209 |
else { |
// Pruefen, welche Attribute angezeigt werden |
| 210 |
FeatureCollection fc = layer.getFeatureCollection(); |
attrTypes.clear(); |
| 211 |
String fcName = fc.getSchema().getTypeName(); |
for (AttributeMetadataInterface amd : amdMapVisibleOnly) { |
| 212 |
FeatureSource fs = new MemoryDataStore(fc) |
AttributeDescriptor type = schema.getDescriptor(amd.getName()); |
| 213 |
.getFeatureSource(fcName); |
if (attrFilter == null || attrFilter.accept(type)) |
| 214 |
setFeatureSource(fs, layer.getAttributeMetaDataMap(), filter); |
attrTypes.add(type); |
| 215 |
} |
} |
| 216 |
} catch (Exception err) { |
// Namen und Attribut-Indizes der angezeigten Spalten ermitteln |
| 217 |
throw new RuntimeException(err); |
colNames = new String[attrTypes.size()]; |
| 218 |
} |
colTooltips = new String[attrTypes.size()]; // Only set and used in |
| 219 |
} |
// StyledFeatureCollectionTableModel |
| 220 |
|
colClass = new Class[attrTypes.size()]; |
| 221 |
/** |
attrIdxForCol = new int[attrTypes.size()]; |
| 222 |
* Sets the {@code StyledFeatureCollection} as new data source for the |
for (int i = 0; i < colNames.length; i++) { |
| 223 |
* table. |
AttributeDescriptor descriptor = schema |
| 224 |
* |
.getDescriptor(amdMapVisibleOnly.get(i).getName()); |
| 225 |
* @param fs |
|
| 226 |
* the feature source |
// Not so nice in 26: find the index of an attribute... |
| 227 |
* @param amd |
int idx = schema.getAttributeDescriptors().indexOf(descriptor); |
| 228 |
* {@link AttributeMetaData}-Map to define the visible attributes |
attrIdxForCol[i] = idx; |
| 229 |
* and translation |
|
| 230 |
*/ |
String attName = schema.getAttributeDescriptors().get(idx) |
| 231 |
public void setFeatureCollection(StyledFeatureSourceInterface layer, |
.getLocalName(); |
| 232 |
Filter filter) { |
colNames[i] = amdMap.get(attName).getTitle().toString(); |
| 233 |
this.layer = layer; |
AttributeMetadataInterface amd = amdMap.get(attName); |
| 234 |
try { |
colTooltips[i] = "<html>" + amd.getDesc().toString() + "<br>" |
| 235 |
if (layer == null) |
+ amd.getName() + "</html>"; |
| 236 |
setFeatureSource(null, null, null); |
colClass[i] = schema.getAttributeDescriptors().get(idx) |
| 237 |
else |
.getType().getBinding(); |
| 238 |
setFeatureSource(layer.getGeoObject(), layer |
} |
| 239 |
.getAttributeMetaDataMap(), filter); |
} |
| 240 |
} catch (Exception err) { |
|
| 241 |
throw new RuntimeException(err); |
// store feature indexes in HashMap to optimize findFeature(.) |
| 242 |
} |
featureIdx = new HashMap<String, Integer>(); |
| 243 |
} |
for (int i = 0; i < featureArray.length; i++) |
| 244 |
|
if (featureArray[i] != null) |
| 245 |
/** |
featureIdx.put(featureArray[i].getID(), i); |
| 246 |
* Resets the filter for the table. |
// |
| 247 |
* |
// // translate the column names |
| 248 |
* @param filter |
// if (amdMap != null) { |
| 249 |
* a filter |
// for (int i = 0; i < colNames.length; i++) { |
| 250 |
*/ |
// colTooltips[i] = amdMap.get(colNames[i]).getDesc().toString() |
| 251 |
public void setFilter(Filter filter) { |
// + "<br>" + colNames[i]; |
| 252 |
try { |
// colNames[i] = amdMap.get(colNames[i]).getTitle().toString(); |
| 253 |
setFeatureSource(this.featureSource, this.origAMD, filter); |
// |
| 254 |
} catch (Exception err) { |
// } |
| 255 |
LOGGER.error("Setting the filter of the table model", err); |
// } |
| 256 |
throw new RuntimeException(err); |
if (fireTableStructureChanged) |
| 257 |
} |
fireTableStructureChanged(); |
| 258 |
} |
|
| 259 |
|
} |
| 260 |
/** |
|
| 261 |
* @return <code>Filter.INCLUDE</code> or the {@link Filter} applied to the |
/** |
| 262 |
* Features |
* @return Cached bounds for the whole dataset (without applying the filter) |
| 263 |
*/ |
* or <code>null</code> |
| 264 |
public Filter getFilter() { |
*/ |
| 265 |
return this.filter; |
public Envelope getBounds() { |
| 266 |
} |
return bounds; |
| 267 |
|
} |
| 268 |
/** |
} |
|
* After calling {@code super.reorganize(.)} this method replaced the column |
|
|
* descriptions with the titles of the {@code AttributeMetaData}. |
|
|
* |
|
|
* @param fireTableStructureChanged |
|
|
* indicates whether a table event is initiated after reorganize |
|
|
*/ |
|
|
@Override |
|
|
protected void reorganize(boolean fireTableStructureChanged) { |
|
|
super.reorganize(false); |
|
|
// translate the column names |
|
|
if (visibleAMD != null) { |
|
|
Iterator<Integer> keys = visibleAMD.keySet().iterator(); |
|
|
for (int i = 0; i < colNames.length && keys.hasNext(); i++) { |
|
|
Translation title = visibleAMD.get(keys.next()).getTitle(); |
|
|
if (!I8NUtil.isEmpty(title)) { |
|
|
// System.out.println("set colname " + i + " to " + |
|
|
// title.toString()); |
|
|
colNames[i] = title.toString(); |
|
|
} |
|
|
} |
|
|
} |
|
|
if (fireTableStructureChanged) |
|
|
fireTableStructureChanged(); |
|
|
} |
|
|
|
|
|
/** |
|
|
* @return Cached bounds for the whole dataset (without applying the filter) |
|
|
* or <code>null</code> |
|
|
*/ |
|
|
public Envelope getBounds() { |
|
|
return bounds; |
|
|
} |
|
|
} |
|
Parent Directory
| 
Revision Log
| 
Patch