JSON-java/JSONWriter.java at master · kamshory/JSON-java · GitHub

History

418 lines (387 loc) · 14.8 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

323

324

325

326

327

328

329

330

331

332

333

334

335

336

337

338

339

340

341

342

343

344

345

346

347

348

349

350

351

352

353

354

355

356

357

358

359

360

361

362

363

364

365

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

382

383

384

385

386

387

388

389

390

391

392

393

394

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

415

416

417

418

package org.json;

import java.io.IOException;

import java.math.BigDecimal;

import java.util.Collection;

import java.util.Map;

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all

copies or substantial portions of the Software.

The Software shall be used for Good, not Evil.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

SOFTWARE.

/**

* JSONWriter provides a quick and convenient way of producing JSON text.

* The texts produced strictly conform to JSON syntax rules. No whitespace is

* added, so the results are ready for transmission or storage. Each instance of

* JSONWriter can produce one JSON text.

*

* A JSONWriter instance provides a <code>value</code> method for appending

* values to the

* text, and a <code>key</code>

* method for adding keys before values in objects. There are <code>array</code>

* and <code>endArray</code> methods that make and bound array values, and

* <code>object</code> and <code>endObject</code> methods which make and bound

* object values. All of these methods return the JSONWriter instance,

* permitting a cascade style. For example, <pre>

* new JSONWriter(myWriter)

* .object()

* .key("JSON")

* .value("Hello, World!")

* .endObject();</pre> which writes <pre>

* {"JSON":"Hello, World!"}</pre>

*

* The first method called must be <code>array</code> or <code>object</code>.

* There are no methods for adding commas or colons. JSONWriter adds them for

* you. Objects and arrays can be nested up to 200 levels deep.

*

* This can sometimes be easier than using a JSONObject to build a string.

* @author JSON.org

* @version 2016-08-08

public class JSONWriter {

private static final int maxdepth = 200;

/**

* The comma flag determines if a comma should be output before the next

* value.

private boolean comma;

/**

* The current mode. Values:

* 'a' (array),

* 'd' (done),

* 'i' (initial),

* 'k' (key),

* 'o' (object).

protected char mode;

/**

* The object/array stack.

private final JSONObject stack[];

/**

* The stack top index. A value of 0 indicates that the stack is empty.

private int top;

/**

* The writer that will receive the output.

protected Appendable writer;

/**

* Make a fresh JSONWriter. It can be used to build one JSON text.

public JSONWriter(Appendable w) {

this.comma = false;

this.mode = 'i';

this.stack = new JSONObject[maxdepth];

this.top = 0;

this.writer = w;

}

/**

* Append a value.

* @param string A string value.

* @return this

* @throws JSONException If the value is out of sequence.

private JSONWriter append(String string) throws JSONException {

if (string == null) {

throw new JSONException("Null pointer");

}

if (this.mode == 'o' || this.mode == 'a') {

try {

if (this.comma && this.mode == 'a') {

this.writer.append(',');

}

this.writer.append(string);

} catch (IOException e) {

// Android as of API 25 does not support this exception constructor

// however we won't worry about it. If an exception is happening here

// it will just throw a "Method not found" exception instead.

throw new JSONException(e);

}

if (this.mode == 'o') {

this.mode = 'k';

}

this.comma = true;

return this;

}

throw new JSONException("Value out of sequence.");

}

/**

* Begin appending a new array. All values until the balancing

* <code>endArray</code> will be appended to this array. The

* <code>endArray</code> method must be called to mark the array's end.

* @return this

* @throws JSONException If the nesting is too deep, or if the object is

* started in the wrong place (for example as a key or after the end of the

* outermost array or object).

public JSONWriter array() throws JSONException {

if (this.mode == 'i' || this.mode == 'o' || this.mode == 'a') {

this.push(null);

this.append("[");

this.comma = false;

return this;

}

throw new JSONException("Misplaced array.");

}

/**

* End something.

* @param m Mode

* @param c Closing character

* @return this

* @throws JSONException If unbalanced.

private JSONWriter end(char m, char c) throws JSONException {

if (this.mode != m) {

throw new JSONException(m == 'a'

? "Misplaced endArray."

: "Misplaced endObject.");

}

this.pop(m);

try {

this.writer.append(c);

} catch (IOException e) {

// Android as of API 25 does not support this exception constructor

// however we won't worry about it. If an exception is happening here

// it will just throw a "Method not found" exception instead.

throw new JSONException(e);

}

this.comma = true;

return this;

}

/**

* End an array. This method most be called to balance calls to

* <code>array</code>.

* @return this

* @throws JSONException If incorrectly nested.

public JSONWriter endArray() throws JSONException {

return this.end('a', ']');

}

/**

* End an object. This method most be called to balance calls to

* <code>object</code>.

* @return this

* @throws JSONException If incorrectly nested.

public JSONWriter endObject() throws JSONException {

return this.end('k', '}');

}

/**

* Append a key. The key will be associated with the next value. In an

* object, every value must be preceded by a key.

* @param string A key string.

* @return this

* @throws JSONException If the key is out of place. For example, keys

* do not belong in arrays or if the key is null.

public JSONWriter key(String string) throws JSONException {

if (string == null) {

throw new JSONException("Null key.");

}

if (this.mode == 'k') {

try {

JSONObject topObject = this.stack[this.top - 1];

// don't use the built in putOnce method to maintain Android support

if(topObject.has(string)) {

throw new JSONException("Duplicate key \"" + string + "\"");

}

topObject.put(string, true);

if (this.comma) {

this.writer.append(',');

}

this.writer.append(JSONObject.quote(string));

this.writer.append(':');

this.comma = false;

this.mode = 'o';

return this;

} catch (IOException e) {

// Android as of API 25 does not support this exception constructor

// however we won't worry about it. If an exception is happening here

// it will just throw a "Method not found" exception instead.

throw new JSONException(e);

}

throw new JSONException("Misplaced key.");

}

/**

* Begin appending a new object. All keys and values until the balancing

* <code>endObject</code> will be appended to this object. The

* <code>endObject</code> method must be called to mark the object's end.

* @return this

* @throws JSONException If the nesting is too deep, or if the object is

* started in the wrong place (for example as a key or after the end of the

* outermost array or object).

public JSONWriter object() throws JSONException {

if (this.mode == 'i') {

this.mode = 'o';

}

if (this.mode == 'o' || this.mode == 'a') {

this.append("{");

this.push(new JSONObject());

this.comma = false;

return this;

}

throw new JSONException("Misplaced object.");

}

/**

* Pop an array or object scope.

* @param c The scope to close.

* @throws JSONException If nesting is wrong.

private void pop(char c) throws JSONException {

if (this.top <= 0) {

throw new JSONException("Nesting error.");

}

char m = this.stack[this.top - 1] == null ? 'a' : 'k';

if (m != c) {

throw new JSONException("Nesting error.");

}

this.top -= 1;

this.mode = this.top == 0

? 'd'

: this.stack[this.top - 1] == null

? 'a'

: 'k';

}

/**

* Push an array or object scope.

* @param jo The scope to open.

* @throws JSONException If nesting is too deep.

private void push(JSONObject jo) throws JSONException {

if (this.top >= maxdepth) {

throw new JSONException("Nesting too deep.");

}

this.stack[this.top] = jo;

this.mode = jo == null ? 'a' : 'k';

this.top += 1;

}

/**

* Make a JSON text of an Object value. If the object has an

* value.toJSONString() method, then that method will be used to produce the

* JSON text. The method is required to produce a strictly conforming text.

* If the object does not contain a toJSONString method (which is the most

* common case), then a text will be produced by other means. If the value

* is an array or Collection, then a JSONArray will be made from it and its

* toJSONString method will be called. If the value is a MAP, then a

* JSONObject will be made from it and its toJSONString method will be

* called. Otherwise, the value's toString method will be called, and the

* result will be quoted.

*

* Warning: This method assumes that the data structure is acyclical.

* @param value

* The value to be serialized.

* @return a printable, displayable, transmittable representation of the

* object, beginning with <code>{</code> (left

* brace) and ending with <code>}</code> (right

* brace).

* @throws JSONException

* If the value is or contains an invalid number.

public static String valueToString(Object value) throws JSONException {

if (value == null || value.equals(null)) {

return "null";

}

if (value instanceof JSONString) {

Object object;

try {

object = ((JSONString) value).toJSONString();

} catch (Exception e) {

throw new JSONException(e);

}

if (object instanceof String) {

return (String) object;

}

throw new JSONException("Bad value from toJSONString: " + object);

}

if (value instanceof Number) {

// not all Numbers may match actual JSON Numbers. i.e. Fractions or Complex

final String numberAsString = JSONObject.numberToString((Number) value);

try {

// Use the BigDecimal constructor for it's parser to validate the format.

@SuppressWarnings("unused")

BigDecimal unused = new BigDecimal(numberAsString);

// Close enough to a JSON number that we will return it unquoted

return numberAsString;

} catch (NumberFormatException ex){

// The Number value is not a valid JSON number.

// Instead we will quote it as a string

return JSONObject.quote(numberAsString);

}

if (value instanceof Boolean || value instanceof JSONObject

|| value instanceof JSONArray) {

return value.toString();

}

if (value instanceof Map) {

Map<?, ?> map = (Map<?, ?>) value;

return new JSONObject(map).toString();

}

if (value instanceof Collection) {

Collection<?> coll = (Collection<?>) value;

return new JSONArray(coll).toString();

}

if (value.getClass().isArray()) {

return new JSONArray(value).toString();

}

if(value instanceof Enum<?>){

return JSONObject.quote(((Enum<?>)value).name());

}

return JSONObject.quote(value.toString());

}

/**

* Append either the value <code>true</code> or the value

* <code>false</code>.

* @param b A boolean.

* @return this

* @throws JSONException

public JSONWriter value(boolean b) throws JSONException {

return this.append(b ? "true" : "false");

}

/**

* Append a double value.

* @param d A double.

* @return this

* @throws JSONException If the number is not finite.

public JSONWriter value(double d) throws JSONException {

return this.value(Double.valueOf(d));

}

/**

* Append a long value.

* @param l A long.

* @return this

* @throws JSONException

public JSONWriter value(long l) throws JSONException {

return this.append(Long.toString(l));

}

/**

* Append an object value.

* @param object The object to append. It can be null, or a Boolean, Number,

* String, JSONObject, or JSONArray, or an object that implements JSONString.

* @return this

* @throws JSONException If the value is out of sequence.

public JSONWriter value(Object object) throws JSONException {

return this.append(valueToString(object));

}

JSON-java/JSONWriter.java at master · kamshory/JSON-java · GitHub

Expand file tree

Breadcrumbs

JSONWriter.java

Latest commit

History

Breadcrumbs

JSONWriter.java

File metadata and controls