How do Java wildcards and PECS guide generic API design?

Applies upper and lower bounded wildcards to producer and consumer APIs while explaining their limits.

1Say itAnswer out loud first

2CompareCompare with Core answer

3RefineRefine with Stronger and Advanced

TL;DR

PECS means producer extends, consumer super. If a parameter only produces T values for the method to read, List<? extends T> can accept lists of T or its subtypes. If the method consumes T values by adding them, List<? super T> can accept a list of T or one of its supertypes. If the method must both read and write the exact same type, an invariant List<T> is usually appropriate.

Full answer below

Practice focus

Use-site variance, safe reads and writes, wildcard return-type judgment, and practical API signatures.

Answer first

Answer path

Core answer first, then checkpoints toward a stronger answer.

Start
Core answer
Start here. This is the direct spoken answer to practice first.
Overview
PECS is a memory aid for safe operations, not a rule to place wildcards on every generic type.
PECS means producer extends, consumer super. If a parameter only produces T values for the method to read, List<? extends T> can accept lists of T or its subtypes. If the method consumes T values by adding them, List<? super T> can accept a list of T or one of its supertypes. If the method must both read and write the exact same type, an invariant List<T> is usually appropriate.

Review signals

Use these to catch weak phrasing, shallow reasoning, and risky claims.

Common mistakesCandidateCommon mistakesMistakes that weaken the answer or signal shallow understanding.Open details

Details

Reversing producer and consumer bounds.
Calling an extends-bounded collection strictly immutable.
Expecting a super-bounded collection to return values as T.
Returning wildcard-heavy types without a clear caller benefit.

How do Java wildcards and PECS guide generic API design?

Practice focus

Answer path

Overview

Review signals

Follow-up prompts

Continue practice

Skill areas

Suggest an improvement

Found this answer useful?