Package org.apache.juneau.rest.server.arg

Class RecordReaderArg

java.lang.Object

org.apache.juneau.rest.server.arg.SimpleRestOperationArg

org.apache.juneau.rest.server.arg.RecordReaderArg

All Implemented Interfaces:

RestOpArg

public class RecordReaderArg
extends SimpleRestOperationArg

Resolves method parameters of type RecordReader (or any subtype) on RestOp-annotated Java methods.

The parameter value is resolved by:

1. Negotiating the request's Content-Type to a matched Parser.
2. Building a request-configured ParserSession and calling readRecords(input) on it where input is the request reader (text formats) or input stream (binary formats).
3. Verifying the returned cursor's runtime type is assignable to the declared parameter type — this enforces the two-layer resolution for concrete cursor subtypes (e.g. JsonTokenReader).

Rejection paths (all surfaced as HTTP 415 / 406):

• No parser matched the Content-Type — resolution returns null and the framework rejects the request (415/406 via the empty match).
• Matched parser does not implement RecordReadable — throws UnsupportedMediaType (415).
• Matched parser produces a cursor not assignable to the declared parameter type — throws UnsupportedMediaType (415).

See Also:

• Java Method Parameters

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RecordReaderArg(Class<?> declaredType)	Constructor.

Method Summary

Modifier and Type	Method	Description
static RecordReaderArg	create(ParameterInfo paramInfo)	Static creator.
Class<?>	getDeclaredType()	Returns the declared parameter type for diagnostic / introspection use.

Methods inherited from class org.apache.juneau.rest.server.arg.SimpleRestOperationArg

resolve

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

RecordReaderArg

protected RecordReaderArg(Class<?> declaredType)

Constructor.

Parameters:

declaredType - The declared parameter type (used to verify the matched parser's cursor type is assignable to the parameter).

Method Details

create

public static RecordReaderArg create(ParameterInfo paramInfo)

Static creator.

Parameters:

paramInfo - The Java method parameter being resolved. Must not be null.

Returns:

A new RecordReaderArg, or null if the parameter type is not RecordReader or a subtype (other than TokenReader — that case is handled by TokenReaderArg).

getDeclaredType

public Class<?> getDeclaredType()

Returns the declared parameter type for diagnostic / introspection use.